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PREFACE 


MANUAL    OBJECTIVES    AND    READER    ASSUMPTIONS 

Since  this  user's  guide  has  two  objectives,  it  is  divided  into  two 
parts.       Each    p=5rt    is    a    complete    manual     in    itself. 

Part  I  (CREATE  USER'S  GUIDE)  contains  the  operation  and  command 
elements   of    the    BCP    interactive   graphics    program   CREATE. 

Part  II  (BCPLIB  USER'S  GUIDE)  describes  the  BCP  graphic  subroutine 
library  (BCPLIB)  modules  and  how  to  use  these  modules  to  integrate 
graphic    output    into    the    user's    specific    application    program. 

INTENDED  AUDIENCE 

Part  I  (CREATE  USER'S  GUIDE)  is  intended  for  the  user  who  has  a 
basic  understanding  of  operating  computer  programs  from  a 
term  inal  . 

Part  II  (BCPLIB  USER'S  GUIDE)  is  intended  fc  r  the  user  who  is  a 
computer    programmer    or    knows    how    to    write    computer    software. 

This    manual     provides     instruction     in     the    use    of    BCP    software.        It 
does      not      provide      information      on      the      FORTRAN      language,      system 
sources,     or      any     DIGITAL     operating      system.  It      also      assumes 

^-imiliarity    with    the    following. 

•  For    RSX-II*^    BCP: 

RSX-llM    Operating    System; 

—  R^X-llI^    ^'CR    Operations   Manual,    AA-L678A- IC ;    and 

—  PDP-11    FORTRAN-77    Language. 

•  For    VAX-LI     BCP: 

—  VAX/VMS    Operating    System; 

—  VAX /VMS    Commc^nd    language    User  '  s   Guido,    AA-D023C-TE; 
and 

—  VAX-il    FORTRAN    Language. 


V  I 


DOCUMENT  STRUCTURE 
PART  I 

Chapter  1  consists  o^  general  information  concerning  the  BCF 
software  and  introduces  basic  information  needed  to  understand  the 
BCP  software  and  hence,  the  CREATE  program. 

Chapter  2  describes  how  to  use  the  CREATE  program. 

Appendix  A  lists  the  CREATE  commands  in  alphabetical  order  and 
describes  each  command  in  detail. 

Appendix  B  is  a  glossary  of  terminology  used  in  describing  the  I  :P 
software  in  this  document. 

Appendix  C  is  a  list  of  error  messages  that  could  be  returned  by 
the  BCP  software. 


PART  II 

Chapter  1  consists  of  general  information  concerning  the  ncP 
software  and  introduces  basic  information  needed  to  understand  the 
BCP  software  and  hence,  the  BCPLIB  subroutine  library. 

Chapter  2  describes  how  to  use  the  BCPLIB  subroutine  Library. 

Chapter  3  describes  che  RSX-llM  BCP  software  installation 
procedure.   This  includes  both  CREATE  and  BCPLIB  installation. 

Chapter  4  describes  the  VAX/VMS  BCP  software  installation 
procedure.   This  includes  both  CREATE  and  BCPLIB  installation. 

Appendix  A  lists  the  BCPLIB  subroutines  in  alphabet ica 1  order  and 
describes  each  subroutine  in  detail. 

Appendix  B  is  a  glossary  of  terminology  used  throughout  this 
manual  in  describing  the  BCP  software. 

Appendix  C  is  a  list  of  error  returns  from  the  BCPLIB  subroutines 
with  a  description  of  each. 

Appendix  D  consists  of   the  BCP  software   (CREATE  and   BCPLIB) 
installation  verification  procedures. 
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^M  PART  I 

CREATE  (INTERACTIVE  GRAPHICS  PROGRAM)  USER'S  GUIDE 


CHAPTER  1 
INTRODUCTION 


1.1   GENERAL  DESCRIPTION 

The  Barcode  and  Block  Character  Plotter  (BCP)  software  package 
generates  both  barcode  and  block  character  printing  cm  an  LXY 
PRINTER/PLOTTER.  Using  an  interactive  user  program  and  a  library 
of  graphic  routines,  the  BCP  software  package  can  produce: 

•  CODE  39  barcode, 

•  Block  characters, 

•  Horizontal  and  vertical  lines, 

•  Horizontal  and  vertical  bars  (thick  lines), 

•  Horizontal  and  vertical  dash  lines,  and 

•  0.1  inch  text  characters. 
Typical  uses  include  the  creation  of: 

•  Shipping  and  identification  labels, 

•  Forms, 

•  Signs,  and 

•  Inventory  and  accounting  documents. 

1.;,      OVERVIEW 

The  BCP  software  package  is  made  up  of  two  components,  each  de- 
signed   for    a   different    user. 

•  CREATE  is  an  interactive  program  for  the  nont-!chn  ica  1 
user.  CREATE  is  built  on  the  foundation  provided  by 
BCPLIB  and  gives  the  user  an  on-line  graphics  generation 
capability    for    use    in    the    production    environment. 

•  BCPLIB  (BCP  Graphic  Utility  Library)  is  available  for  the 
technical  user  or  programmer  experienced  in  writing 
computer  software.  BCPLIB  is  a  library  of  software 
building  blocks  that  serves  as  a  foundation  for  the 
graphics  applications.  It  provides  graphic  facilities  for 
both    user    application    software    and    the    BCP   CREATE    Program. 

There  are  two  front-ends  (or  ways)  into  the  BCP  software  (Figures 
1-1   and   1-2).      The    front-ends   are   either    through    the: 
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•  Interactive    CREATE    program,    or 

•  Optional    user    application    program. 

Both  of  these  programs  are  built  upon  BCPLIB,  with  each  accepting 
commands  from  a  system's  terminal.  These  front-ends  pass  the 
command  information  on  to  BCPLIB.  This  command  information  is 
called  the  GRAPHIC  REQUEST.  GRAPHIC  REQUESTS  are  processed  by 
BCPLIB  in  two  phases  due  to  physical  limitations  placed  on  the 
program  (such  as  LXY  PRINTER/PLOTTER  paper  movement  and  computer 
memory)  . 

Phase    1 

During  this  phase,  the  GRAPHIC  REQUESTS  are  accepted,  evaluated, 
and  stored  (buffered)  into  a  special  area  of  the  program's  spacs 
in  computer  memory  called  the  REQUEST  BUFFER. 

Phase  2 

Phase  2  is  entered  as  a  result  of  a  special  request  (or  CREATE 
command)  such  as  the  PROCES  request.  During  this  phase,  the 
requests  in  the  buffer  are  processed  into  plottable  information, 
which  is  then  written  or  temporarily  stored  in  the  GRAPHICS  FILE, 
and  is  later  transferred  to  the  LXY  PRINTER/PLOTTER. 

Phases  1  and  2  can  be  repeated  alternately,  until  an  entire  plot 
(which  may  be  more  than  one  page  of  output)  is  completed. 

Once  the  plot  is  completed,  the  contents  of  the  GRAPHICS  FILE  can 
be  transferred  directly  to  the  LXY  PRINTER/PLOTTER  via  the 
following  methods. 

•  For  RSX-llM  —  Use   the   MCR   utility   PIP   (or   PRINT 
f  acil  ity)  . 

•  For  VAX/VMS  —  Use  the  PRINT/NOFEED  command. 

1.3   BCP  SOFTWARE  CONCEPTS 

This  section  explains  the  concepts  that  must  be  understood   in 

order  to  use  the  BCP  software.   They  are: 

•  PLOT  PAGE, 

•  SECTION, 

•  FORMS,  and 

•  LABEL  POINTS. 
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PLOT  PAGE 

The  PLOT  PAGE  is  the  basic  unit  of  plct  out[>jt.  It  Is  an  internal 
software  equivalent  of  the  LXY  PRINTER/PLOTTER  p.vje.  Since  the 
PRINTER/PLOTTER  paper  can  be  of  different  l^n^ths  or  wiiths,  the 
PAGE  boundaries  can  also  be  adjusted  inteinally  to  match  the 
PRINTER/PLOTTER  PAGE  SIZE.  When  GRAPHIC  REQUESTS  are  received  by 
the  software,  the  dimensions  of  the  figures  are  checKed  to  see  it 
they  fit  within  the  paje  boundaries.  GRAPHIC  (or  plcttable) 
information  can  be  generated  for  more  than  one  page,  hut  each  page 
is  treated  individually  and  terminated  by  a  "TOP~OF-FORM"  paper 
movement.  The  "TOP-OF-FORM"  movement  positions  th^e  paper  to  th« 
top  of  the  next  physical  pa.je. 

SECTION 

[f  a  lot  of  GRAPHIC  REQUESTS  are  required  to  generate  a  plot,  tlie 
REQUEST  BUFFER  could  overflow  before  the  output  page  is  complete. 
To  prevent  this.  Phase  2  of  the  GRAPHIC  REQUEST  may  be  triggered 
at  any  time  and  the  requests  received  up  to  that  time  are 
processed.  The  ar>:.a  of  the  page  covered  r.y  the  graphic 
information  in  the  REQUEST  BUFFERS  determines  the  pag«  SECTION. 
Once  a  SECTION  is  processed,  no  more  graphic  input  is  accepted 
that  has  any  part  falling  within  the  range  of  that  SECTION. 
Following  the  output  of  that  SECTION,  a  new  SECTION  is  defined  by 
updating  the  SECTION  origin  position  to  the  start  of  the  unusad 
part  of  the  page.  The  REQUEST  BUFFERS  have  a  capacity  that  can  be 
exceeded  by  the  number  of  GRAPHIC  REQUESTS,  graphic  data  should  hi 
entered  in  a  top- Lo-bottom  sequence.  However,  for  mrri^  plots,  the 
REQUEST  BUFFER  is  adequate  to  store  the  graphics  tor  the  entire 
page.   SECTIONS  are  defined  and  written  as  the  result  of  the: 

•  PROCES  request, 

•  END  request,  and 

•  REPEAT  request. 

FORMS 

The  BCP  FORMS  facility  provides  a  means  for  the  ur.er  to  uonerats 
the  fixed  portion  of  a  graphic  output  (such  as  labels  and  business 
forms)  and  store  it  for  lat'jr  lise .  This  means  that  the  fixed  part 
of  a  graphic  output  rist  be  generated  only  once.  When  produrinj 
the  final  output,  the  user  can  merge  the  fixed  portion  with  the 
variable  part  of  the  graphic  output.  FORMS  c^n  he  created  during 
the  Phase  1  process  of  the  GRAPHIC  REQUEST.  Graphic  requests 
defining  the  FORM  are  processed  in  the  same  way  as  a  normal 
output.  Phase  2  processing  is  bypassed  and  on  the  completion  of 
the  FORM,  a  special  request  is  called  to  reformat  the  contents  of 
ti  «?  HiiQ'JEST  BUFFERS  and  write  the  rec^Jests  on  the  FORMS  file. 
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Once  a  FORM  is  created,  it  can  be  repeatedly  recalled  daring 
software  production  runs  by  referencing  its  name.  FORMS  are 
called  in  a  similar  manner  to  standard  graphic  figures  such  as 
barcodes.  When  a  FORM  is  called,  the  FORM  base  is  aligned  with 
the  REFERENCE  ORIGIN  (Section  1.4)  position  on  input.  Th-  FORM 
data  is  read  from  the  FORM  file,  reformatted,  and  stored  in  the 
REQUEST  BUFFER  like  any  standard  figure.  The  variable  portion  of 
the  FORM  can  be  inserted  at  this  time  by  making  additional  GRAPHIC 
REQUESTS. 

A  FORM  can  be  used  to  define  another,  more  complex  FORM.  A  FORM 
can  also  be  fixed  into  memory  for  repeated  use.  Not  only  does 
this  save  I/O  activity  on  the  FORM  file,  but  a  single  image  of  the 
FORMS  graphics  may  be  stored  for  any  number  of  different  positions 
of  the  FORM  on  the  plot  page,  thus  saving  REQUhST  BUFFER  space. 

LABEL  POINTS 

LABEL  POINTS  are  used  as  an  aid  in  the  positioning  of  the  variable 
portion  of  FORMS  di;jing  production  runs.  LABEL  POINTS  are  a  set 
of  up  to  12  predefined  positions  c.  the  FORM  which  ar.-  selected  by 
number  (1  through  12)  to  position  the  variable  graphics.  The  X 
and  Y  values  associated  with  each  LABEL  POINT  are  offset  (or 
incremental)  distances  from  the  FORM  base.  The  FORM  base  is 
aligned  with  the  REFERENCE  ORIGIN  (Section  1.4)  when  the  FORM  is 
requested  and  the  LABEL  POINTS  then  become  GRAPHIC  POINTER 
(Section  1,4)  positions  on  the  PLOT  PAGE.  By  requesting  a  LABLL 
POINT  by  number,  the  user  causes  the  GRAPHIC  POINTER  to  be  moved 
to  the  position  indicated  (by  the  LABEL  POINT)  and  additional 
graphic  input  can  then  be  added. 

1.4   BCP  SOFTWARE  COORDINATE  SYSTEM 

To  fl  id  in  the  placement  of  the  graphic  figures  on  the  PLOT  PAGE 
(see  Figures  1-3  and  1-4),  the  BCP  software  provides  a  coordinate 
system  that  is  definrd  as: 

<  PAGE  ORIGIN, 

•  SECTION  ORIGIN, 

•  REFERENCE  ORIGIN,  and 

•  GRAPHIC  POINTER. 

PAGE  ORIGIN 

Upper  left-hand  corner  of  the  physical  line  printet  paper.  This 
is  plot  (or  absolute)  position  (0,0). 

The  ABSCISSA  K  is  defined  as  being  the  vertical  direction  starting 
from  the  PAGE  ORIGIN,  increasing  in  value  to  the  bottom  of  the 
page.  Thus,  the  positive  X  direction  corresponds  with  the  paper 
movement  and  maintains  a  '  c  ight-har;ded  coordinate  system.  The 
resolution  is  0.1  inch. 


m 
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The  ORDINATE  Y  is  defined  as  being  the  horizontal  direction 
starting  from  the  PAGC  ORIGIN,  increasing  in  val'je  to  tne 
right-hand  side  of  the  page.   The  resolution  is  0.1  inch. 

SECTION  ORIGIN 

This  is  the  starting  position  of  the  current  page  section.  The  Y 
coordinate  is  always  0  and  its  X  coordinate  (XS)  is  an  offset 
distance  from  the  PAGE  origin.  The  SECTION  ORIGIN  affects  the 
user  by  becoming  the  lower  limit  for  the  X  coordinate  on  his 
GRAPHIC  REQUESTS.  Initially,  the  SECTION  ORIGIN  starts  at  the 
PAGE  origin  which  is  0,0.  As  sections  are  processed,  it  advances 
by  the  section  height  to  define  the  start  of  the  next  section. 

REFERENCE  ORIGIN 

This  is  a  moveable  coordinate  system  within  the  PAGE.  Graphic 
figures  are  placed  on  the  PAGE  with  respect  to  the  REFERENCE  ORI- 
GIN (Xr,Yr).  The  X  and  Y  position  for  the  figures  are  offset 
distances  from  this  point.  The  RRFERENCE  ORIGIN  is  moved  by 
specifying  new  values  for  the  Xr  and  Yr  offsets  from  the  PAGE 
origin.  The  REFERENCE  ORIGIN  is  a  mechanism  to  provide  position 
independence  (with  respect  to  the  PAGE)  for  the  graphic  figures  on 
the  PAGE.  This  is  an  important  mechanism  in  processing  FORMS  and 
REPEAT  requests. 

The  Xr  value  of  the  REFERENCE  ORIGIN  must  not  be  smaller  than  the 
SECTION  origin.  As  the  PAGE  sections  are  processed,  the  REFERENCE 
ORIGIN  is  advanced  automatically  with  the  SECTION  origin. 

GRAPHIC  POINTER 

Current  position  for  graphic  data  entry  is  expressed  as  an  offset 
Xc  and  Yc  from  the  REFERENCE  ORIGIN.  Neither  Xc  nor  Yc  may  take 
on  negative  values  (for  example,  cannot  be  smaller  than  the 
REFERENCE  ORIGIN)  . 

1.5   GRAPHIC  OUTPUT  ON  THE  LXY  PRINTER/PLOTTER 

The  LXY  PRINTER/PLOTTERS  place  physical  limitations  on  the  BCP 
software  operation.  The  PRINTER/PLOTTERS  can  only  accept 
plcttable  data  (raster  data)  one  raster  line  (a  line  thickness  of 
one  dot,  0.0i39  inch)  at  a  time  in  a  top-of-page  to  bottom-o f-page 
and  page-by-page  sequence. 

The  LXY  PRINTER/PLOTTER  paper  moves  only  in  a  forward  tiirection, 
so  that  all  graphic  output  must  be  coordinated  with  the  printing 
movement  of  the  paper.  The  plo'  data  must  be  sorted  and  written 
on  the  PRINTER/PLOTTER  one  ras.er  line  at  a  time  in  a  sequence 
acceptable  to  the  PRINTER/PLOTTER.  This  places  restrictions  on 
the  sequence  of  GRAPHIC  REQUESTS  entries  by  the  user.  As 
mentioned  in  SecLion  1.3,  the  BCP  software  sorts  the  stored 
requests  according  to  physial  position  on  the  PAGE.  Also,  the  BCP 
software  can  only  accept  graphic  input  in  order  according  to  PAGE. 
The  restrictions  to  the  order  of  graphic  input  on  '^he  PAGE  depends 
on  the  number  of  requests  and  PAGE  SECTIONS. 
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1.6      BCPLI3  GRAPHICS  PLACEMENT 

1.6.1  Inserting  Forms  or.  the  PLOT  PAGE 

FORMS  are  inserted  on  the  PLOT  PAGE  at  the  current  REFEKENCE  ori- 
gin (Figure  1-3).  The  REFERENCE  ORIG  "'  coincides  with  the  FORM 
BASE.  The  FORM  graphics  are  drawn  fron'  this  point  down  the  page 
(an  increasing  value  of  X)  until  the  FORM  length  (FLIMX)  is 
reached.  In  the  same  way,  the  FORM  is  drawn  across  the  page  until 
the  FORM  (FLIMY)  width  is  reached. 

The  FORM  LABEL  POINTS,  being  offset  values  from  the  FORM  BASE,  now 
become  GRAPHIC  POINTER  values. 

The  REFERENCE  origin  is  moved  in  one  of  several  ways.  It  may  oe 
moved : 

•  As  the  result  of  entering  the  TAB  request  (for  ex.imple, 
VTAB  or  HTAB  commands  for  the  CREATE  user  or  a  call  to  the 
TAB  subroutine  for  the  BCPLIB  u^^er), 

•  As  the  result  of  entering  the  MOVREF  request, 

•  As  the  result  of  entering  the  GETFRM  and  P'JTFRM  requests. 
These  requests  contain  X  and  Y  parameters  to  reposition 
the  REFERENCE  origin  prior  to  the  actual  form  insertion, 
or 

•  As  the  result  of  action  taken  at  the  completion  of  the 
PAGE,  PRINT,  and  REPEAT  requests.  The  REFERENCE  ORIGIN  i  :i 
moved  to  the  new  PAGE  or  SECTION  origin  according  to  the 
request . 

1.6.2  Inserting  Graphic  Figures  on  the  PLOT  PAGE 

NOTE 
Sufficient  space  (in  both  height  and  width) 
must  be  made  available  for  the  graphic  figure 
that  is  to  be  drawn.  The  GRAPHIC  POINTER 
position  (Xc,  Yc)  must  be  chosen  so  that 
enough  space  in  height  and  width  is  available 
to  draw  the  graphic  figure. 

All  graphic  figures  are  inserted  into  the  PLOT  PAGE  at  the  cur- 
rent GRAPHIC  POINTER  position.  Figure  1-4  illustrates  how  the 
figure  is  placed  using  the  block  Character  A  as  an  example.  Tht- 
GRAPHIC  POINTER  (Xc,  Yc)  is  assumed  to  he  on  the  lower  left  cor- 
ner of  the  figure,  which  is  then  drawn  upward  on  the  page  (a  de- 
creasing X  direction)  until  reaching  the  figure  height  and  to  the 
right  by  its  width  (SIZE). 

The  new  position  of  the  GRAPHIC  POINTER  is  then  set  to  the  lower 
right  corner  figure  plus  an  intercharacter  space  (Xce,  Yce)  .   Tht^ 
user  should  be  cautioned  that  before  placing  the  figure  nn     tht' 
PLOT  PAGE,  the  X  values  for  the  GRAPHIC  POINTER  position  (Xc,  Yc) 
must  be  at  least  as  great  as  the  figure  height  (SIZE). 

1-8 


PAGE 


• 


-r       Xs 


CURRENT 
SECTION 


PAGE 


i 


XLim 


YLim 


SECTION 

ORKjIN 


REFERENCE 

COORDINATE 

SYSTEM 


1 


REf  ERLNCE 

COORDINATE 

SYSTEM 


Fiyure    1-1       FOHMJ 


1-9 


PAGE 


CURRENT 
SECTION 


PAGE 


XLim 


INTER 

CHARACTER 

SPACE 


END  OF 

FIGURE  INSERTION 


YLim 


St  (,  rujN 
ORIGIN 


REFERENCE 

COOROINATE 

SYSTEM 


RERRENCE 

COORDINATE 

SYSTEM 


Figure    i-4      Graphics    Insertion 


• 


1-10 


For  the  LINES  (VLINE,  VDASH,  HLINE,  HDASH) ,  the  direction  is  im- 
plicit in  the  subroutine  argument  LENGTH  which  may  have  either  a 
positive  or  negative  value. 

The  GRAPHIC  POINTER  is  moved  in  one  of  several  ways.  It  may  be 
moved : 

•  As  the  result  of  entering  a  MOVPTR  request, 

•  As  the  result  of  entering  a  request  to  draw  any  graphic 
figure  (BLOCK,  BCODE,  TEXT,  etc.).  Each  graphic  figure 
request  includes  parameters  to  reposition  the  GRAPHIC 
POINTER  before  actual  figure  insertion, 

•  As  the  result  of  any  request  that  moves  the  REFERENCE 
ORIGIN  (Section  1.4).  Whenever  the  REFERENCE  ORIGIN  is 
moved,  the  GRAPHIC  POINTER  is  reset  to  0,0, 

•  As  the  result  of  action  taken  upon  completion  of  the 
graphic  figure  requests  (BLOCK,  BCODE,  etc.).  BLOCK, 
BCODE,  and  TEXT  leave  the  POINTER  at  the  end  of  the 
character  list  plus  the  intercharacter  space  (1/6  of  the 
character  width)  ,  or 

•  As  LINES  (VLINE,  HLINE,  VDASH,  HDASH)  leave  the  pointer  at 
the  end  of  the  line. 


^m 
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CHAPTER  2 
GUIDE  TO  USING  THE  CREATE  PROGRAM 


This  chapter  describes  how  to  generate  graphic  or  plot  output 
using  the  CREATE  program  (the  interactive  component  of  the  BCP 
software  package). 

NOTE 
To  use  the  CREATE  program,  the  user  must  be 
familiar  with  the  use  of  computer  terminals 
and  the  following. 

•  For    RSX-llM    BCP: 

-   RSX-llM   operating    systers,    and 

—  RSX-llM/M-Plus    HC?    Operativ  :is    MANUAL,     AA-Lb7  8A--TC , 

•  For    VAX-11    BCP: 

—  VAX/VMS   operating    system,    and 

—  VAX/VMS    Command    Language   User's   Guide,    AA-D023C-TE. 

2.1  INTRODUCTION 

The  CREATE  user  can  generate  GRAPHIC  (plot)  output  (such  as 
barcodes,  block  characters,  etc.)  by  using  a  special  English-like 
command  language.'  Graphic  commands  are  typed  on  the  user's 
terminal  to  the  CREATE  program.  After  receiving  the  command, 
CREATE  can  prompt  for  additional  information.  When  it  has  all  the 
information  it  needs,  it  then  passes  the  command  (as  a  GRAPHIC 
REQUEST,  explained  in  Section  1.2)  onto  the  BCPLIB  to  process  the 
command  and  "draw"  the  specified  figure  or  figures. 

2.2  ACCESSING  AND  USING  CREATE 
The  terminal  user  accesses  CREATE: 

•  For  RSX-llM  BCP  —  By  entering  the  standard  MCR  command 
RUN. 

MCR>RUN  CREATE 

•  For  VAX-11  BCP  —  By  entering  the  RUN  command  after  the 
system  prompt  ($)  . 

SRUN  CREATE 
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When  becoming  active  via  the  RUN  command,  CREATE: 

•  Prompts  the  user  for  commands 

CRT> 

•  The  user  can  now  type  a  command  on  his  terminal.  For 
example : 

CRT>MOVPTR 

•  This  sample  command  makes  a  request  to  move  the  GRAPHIC 
POINTER  position.  CREATE  now  prompts  for  additional  data 
needed  to  process  this  command: 

CRT>ENTER  NEW  GRAPHIC  POINTER  X  POSITION: 
CRT>ENTER  NEW  GRAPHIC  POINTER  Y  POSITION: 

•  Now  the  user  must  respond  with  the  new  POINTER  position, 
in  whole  and/or  tenths  of  inches  from  the  ori'jin. 

The  CREATE  dialogue   (prompting  sequence)   may  be  bypassed  when 

entering  commands  by  typing  a  one-line  command  statement  that 

includes  the  command  parameters  (data)  separated  by  commas.  For 
example: 

CRT>MOVPTR  3.0,4.0 

2.3   ENTERING  CREATE  COMMANDS 

2.3.1   Conunand  Formats 

CREATE  commands  can  be  entered  in  two  ways. 

•  The  user  can  type  the  entire  command  and  all  the 
supporting  data,  or  command  parameters  on  the  same  line: 

CRT>COMMAND   Parameter  1, Parameter  2  .../OPTIONS 

Example:   CRT>GETFRM  NAME. FRM, 5 . 0, 1 . 0/F 

•  The  user  can  type  the  command  name  and  options  only.  In 
this  case,  CREATE  prompts  the  user  for  the  additional  data 
items  required. 

CRT >COMMAND/OPT IONS 

VALUE    PReMPTl:-    PARAMETER     ENTRY 

VALUE    PR0MPT2:     PARAMETER    ENTRY 

ETC. 
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Example:   CRT>GETFRM/F 

ENTER  FORM  NAME  (EX.BCP.FRM) 
ENTER  NEW  X  REFERENCE  ORIGIN 
ENTER  NEW  Y  REFERE[>'CE  ORIGIN 


BIN, 

5.0 

1.0 


FRM 


2.3.2   Parameters 

A  parameter  is  additional  information  that  is  required  when  a 
command  is  entered.  The  parameters  may  be  included  on  the  command 
line  or  entered  later  in  response  to  a  CREATE  program  prompt  such 
as  : 


CRT>BCODE  "ABCDE" 

o  r 
CRT>BCODE 
ENTER  CHARACTERS: 


'ABODE' 


2.3.3      Options 

An  option  is  additional  information  that  is  not  required  when  a 
command  is  entered.  Options  are  indicated  by  typing  the  character 
"/"      followed      by     the     option      name.  It      the     option      requires     a 

parameter,  the  option  name  is  followed  by  "  =  "  and  the  parameter 
value . 

CRT>BLOCK    "ABCDE''/S  =  1.0/D 

or 
CRT>BLOCK  /S=1.0/D 
ENTER  CHARACTERS:  "ABODE" 


Where : 

S  -  Size  (height  and  width  of  characters) 

D  =  Double  height  (draw  characters  with  height 
double  size) 

2.3.4      Data    Entry 

The    data    supplied    as    parameters    and    options    are    of     the     following 
four    types. 

•  File  Spec  --  This  is  a  file  name  and  is  used  to  define  a 
storage  area  on  one  of  the  system's  peripherals  (disks, 
magtapes,  etc.).  For  a  detailed  description  of  the  file 
specifications   and    their    syntax,    refer    to: 
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—   For  RSX-llM  BCP: 

MCR  Operations  Manual,  AA-Lb78A-TC,  Section  2,2 
--   For  VAX-U  BCP: 

Command  Language  User's  Guide,  AA-D02  3C-TR,  Chapter  2 
Example:    CRT>NEWPLT  BCP.PLT 

•  List  --  This  IS  a  I  i .':  .  of  the  al  phrinumer  ic  characters 
required  by  the  3C00E,  BLOCK,  ancl  TEXT  coiiimands. 
Character  lists  mu"^*-  bo  preceded  by  the  quote  ("i 
character  and  follow^    y  the  same  i^har  acter  . 

Example:   CRT>BCODE  "ABC1214" 

•  Decimals  --  These  are  real  numbers  that  include?  a  dpcimai 
point  and  up  to  one  decimal  place  (for  example,  1.0,  I.  i, 
6.7,  etc . ) . 

Example:   CRT>MOVREF  1.2,2.5 

•  Integer  Numbers  --  These  are  whole  numbers  that  (io  not 
include  a  decimal  point. 

Example:   CRT>BLOCK  "ABCD"/P=3 

NOTE 
P  is  used  to  specify  that  the  characters  ate 
to  be  inserted  at  the  Form  LABEL  POINT  number 
3  (see  Section  1.3  or  the  command  descriptions 
for  BLOCK  and  DEFPNT  in  Appendix  A). 

2.4   GUIDELINES  FOR  USING  CREATE  COMMANDS 

This  section  familiarizes  the  user  with  the  proper  use  of  th*- 
CREATE  commands  needed  to  generate  PLOT  (graphic)  output.  Th-- 
following  10  steps  outline  the  general  rules,  guidolines,  .ind 
order  (or  sequence)  of  command  entry. 

NOTE 
The  HELP  a-^f^    SHOW  commands  are  not  ciefined  in 
the  followii g  outline.   Both  the  HELP  and  SHOW 
commands  can  be  entered  at  any  time  since  they 
do  not  affect  plotting. 

1.   To   start  a   new  plot  generation   session,   typ--   the  i-omm. ht) 
NEWPLT. 

Example:  CRT>NEWPLT 

ENTER  FILE  NAME:  BCP.PLT 
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Comments: 

•  ALl  plots  must  start  with  the  NEWPLT  command.   This  command 
is  not  opt  ional . 

•  NEWPLT  can  only  follow: 

--  The  "RUN  CREATE"  command  (Section  2.2),  Jt 

--  The  CREATE  "END"  command. 

To  proceed  from  here; 

Following  the  NEWPLT  command,  you  can  proceed  with  any  step 
that  follows  below,  except  for  Steps  7,  8,  and  9. 

2.  To  change  the  values  of  internal  parameters,  enter  one  or  mtiro 
of  the  following  optional  commands. 

•  SETPAG  --  To  chanje  the  page  limits  (SIZE). 

•  SETFIG  --  To  change: 

The  block  character  and  barcode  SIZE, 
The  barcode  RATIO  (2:1)  or  (J:l), 
The  block  character  double-height  flag,  or 
The  barcode  text  flag. 

•  SETTAB  --  To  change  the  values  of  the  vertical  and  horizon- 
tal TAB  distances. 

To  proceed  from  here: 

Proceed  to  either  Step  3  or  4.   If  tht-  (-ommand  wis  SETTAB,  y  lU 
can  proceed  to  Step  8. 

3.  To  define  a  FORM,  enter  the  DEFERM  and  DEFPNT  -ommands. 

Example:  CRT>DEFFRM 

ENTER  FORM  FILE  NAME:  FIRST. FRM 

ENTER  FORM  HEIGHT:  6.5 

ENTER  FORM  WIDTH:  'jjt ' 

CRT > DEFPNT 

ENTER    POINT    NUMBER:     2 

ENTER    X     POSITION:      (1-12)     U0 

ENTER    POINT    POSITION:     2.3 
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Note  the  follcwinq  for  DEFPNT: 

•  Enter  additional  (up  tc  12)  DEFPNT  commands  as  needed, 

•  Enter  any  combination  of  Step  4  (below)  commands,  and 

•  Terminate  FORM  with  the  fjAVFRM  command  in  Step  6. 
Comments : 

•  The  DEFFRM  command  is  option.!  I. 

•  This  st'.'P  can  only  be  preceded  by  Steps  1  and  2  above. 

•  DEFFRM  forces  the  BCP  software  to  ent.?r  i  FORMS  definition 
mode  of  operation  in  which: 

—  Up  to  12  LABEL  POINTS  can  be  entered  vii  the  DKFPNT 
command . 

—  All  GRAPHIC  REQUEbTS  entered  at  this  time  are  cons  i  J.t  .-d 
as  part  of  th-^  FOR'-'. 

•  The  FORM  qraphics  a . e  entered  via  Step  4  commands  with  the 
exception  of  P'JTFkM. 

•  Although  the  G  HM  command  can  be  used  while  defining  the 
FORM,  its  FIX  F;  see  3ETFRM  (description  in  Appendix  A) 
option  is  illeji^  in  this  mode. 

•  The  FORM  building  process  must  be  terminated  by  the  SAVFRM 
command  (Step  6 ) . 

To  proceed  from  here: 

Proceed  with  Step  4  below.   Terminate  FORM  lefinition  at  Step 
6  (SAVFRM)  . 

To  enter  ]riphic  figures,  use  one  or  more  of  the  followinj 
commands . 

BLOCK  Draw  block  character/s. 

BCODE  Draw  CODE  39  barcode. 

TEXT  Draw  text  characters. 

VLINB:  Draw  a  vertical  line. 

HLINE  Draw  a  horizontal  line. 

VDASH  Draw  a  vertical  dashed  line. 
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•  HDASH     Draw  a  horizontal  dashed  line. 

•  GETFRM     Enter  a  predefined  form. 

•  PUTFRM    Reuse  a  "fixed"  form  at  a  new  position. 
Comments; 

When  using  GETFRM: 

•  A  FORM  insertion  mode  of  operation  is  entered  where  LABEL 
points  can  be  accessed. 

•  GETFRM  is  normally  terminated  by  the  ENDFRM  command  (Step 
5)  . 


• 


During  FORM  definition,  GETFRM  cannot  be  used  with  the  FIX 
(/F;  see  GETFRM  description  in  Appendix  A)  option. 

To  proceed  from  here; 

Proceed  with  any  of  the  steps  that  follow.   However,  if  GETFRM 
or  PUTFRM  was  entered,  proceed  with  Step  5. 

5.   To  terminate  FORM  insertion  (originating  from  the  GETFRM  or 
PUTFRM  commands) ,  enter  ENDFRM. 

Example:  CRT>ENDFRM 

Comments; 

•  The  GETFRM  and  PUTFRM  commands  are  terminated  either  by 
ENDFRM,  another  GETFRM  or  PUTFRM  command,  or  by  the  Phase  2 
process  (see  Chapter  1)  that  is  brought  on  by  one  of  the 
following  commands. 

—  PROCES 

—  PAGE 

—  REPEAT 

—  END 

•  Following  ENDFRM,  figure  insertion  using  LABEL  POINTS 
,annot  be  made  (see  the  P  option  for  the  GRAPHIC  commands). 

To  proceed  from  here; 

•  If  you  are  in  the  FORM  Definition  mode  (DFFFRM)  ,  proceed 
with  either  Step  4  or  6. 

•  If  you  are  not  in  the  FORM  Definition  mode,  proceed  with 
either  Step  4,  7,  8,  9,  or  10. 
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^    To   terminate  FORM  definition  and  save  the  FORM,  enter   the 
SAVFRM  command  : 

Example:  CRT>SAVFRM 

Comments: 

SAVFRM  must  be  used  to  terminate  the  FORM  definition  started 
by  th-  DEFFRM  command. 

To  proceed  fiom  here: 

Proceed  to  either  Step  2,  3,  4  or  10. 

7.  To   terminate   and   process   the   current   page   section,   enter 
PROCES. 

Example:  CRT>PROCES 

Comments: 

This  is  an  optional  command  used  to  segment  a  PLOT  page  into 
smaller,  more  manageable  sections.  The  current  concents  cl 
the  REQUEST  BUFFEr<  is  processed  into  plottable  data  and 
written  on  the  graphic  f.le.  The  buffers  are  «-iien  cleared. 
The  height  of  the  graphic  figures  in  the  REQUEST  BUFFER 
determines  the  section  height.  However,  if  the  section  height 
is  not  a  multiple  of  0.5  inch,  it  is  adjusted  upwards  to  the 
next  0.5  inch  increment. 

To  proceed  from  here; 

To  proceed  from  here,  you  may  go  back  to  Step  4  or  ahead  to 
either  Step  9  or  10. 

8.  To  repeat  the  currently  defined  graphics  (current  contents  of 
the  REQUEST  BUFFER),  use  the  REPEAT  command. 

Example:  CRT>REPEAT  2,3 

Comments : 

REPEAT  makes  the  following  assumptions: 

•  The  intervals  between  the  graphics  being  repeated  is 
determined  by  the  values  assigned  to  TABH  and  TABV  (see 
SETTAB  command) . 

•  TABV  must  be  a  multiple  of  0.5  inch. 

•  REPEAT  acts  upon  the  entire  contents  of  the  REQUEST  BUFFER, 
not  just  the  last  graphic  figure  entered. 

•  Following  REPEAT  by  the  PROCES  command  is  unnecessary. 
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To  proceed  from  here; 

From  here,  proceed  with  either  Step  4  or  10. 

9.   To  terminate  the  current  PLOT  page  and  start  a  new  page, 
enter  the  PAGE  command. 

Example:  CRT>PAGE 

Comments; 

PAGE  causes  the  current  contents  of  the  REQUEST  BUFFERS  to  be 
processed  and  output.  Following  this,  an  LXY  "TOP-OF-FORM" 
character  is  output  to  the  printer.  The  PLOT  is  then  reini- 
tialized to  the  top  of  the  next  page.  It  is  not  necessary  to 
enter  the  PROCES  command  to  process  the  current  contents  of 
the  REQUEST  BUFFERS  before  PAGE. 

To  proceed  from  here; 

From  here,  proceed  with  either  Step  4  or  10. 

10.   To  terminate  the  current  PLOT  session,   use  either  of  the 
following  two  commands. 

•  END  —  Terminates  PLOT  and  becomes  available  to  accept  a 
NEWPLT  command  to  begin  a  new  PLOT. 

•  EXIT  —  Terminates  the  PLOT  and  the  CREATE  program. 
Comments ; 

None 

To  proceed  from  here: 

•  END  can  be  followed  by  NEWPLT  to  start  the  next  PLOT. 

•  EXIT  can  be  followed  by  the  RUN  CREATE  command  to  restart 
the  program. 

2.5   CREATE  POINTERS 

This  section  supplements  Section  2.4  by  focusing  upon  actions  you 
should  take  if  you  have  special  needs  or  if  things  go  wrong. 

2.5.1  What  to  Do  if  an   Error   Message  Is   Received   Following   a 
CREATE  Command  Entry 

Errors  can  originate  from  two  different  sources.   They  are  the: 

•  System  (RSX-llM,  VAX/VMS,  FORTRAN,  etc.),  and 

•  BCP  software. 
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Typically,  errors  reported  by  the  system  are  fatal  and  the  CREATE 
program  aborts  and  the  current  PLOT  is  lost. 

The  BCP  software  detects  nonfatal  system  errors,  CREATP]  '^ommand 
errors,  and  miscellaneous  PLOT  errors  such  as  paqe  limit 
violations.  These  errors  are  reported  to  the  user  on  the  terminal 
(see  Appendix  C)  in  English  messages.  In  this  case,  the  last 
CREATE  command  that  caused  the  error  situation  is  aborted  with  no 
change  in  either  the  state  of  the  program  or  the  graphic  output. 
You  may  continue  from  here  with  further  command  entry. 

2.5.2  How  to  Generate  a  Multipage  Plot 
Solution : 

•  Use  the  PAGE  command  (rather  than  PROCES)  for  the  last 
section  of  each  page. 

•  However,  if  the  REPEAT  command  is  used,  there  is  no  need 
to  use  the  PAGE  command.  REPEAT  automatically  calls  the 
PAGE  command  at  the  appropriate  time. 

2.5.3  If  the  REQUEST  BUFFER  Is  Filled 

The  REQUEST  BUFFER  can  hold  up  to  132  graphic  -ommands  (BLOCK 
characters,  BARCODES,  etc.).  The  actual  number  varies  with  the 
amount  of  information  that  is  stored  by  the  individual  requests. 
Some  requests  require  more  space  than  others.  The  GETFRM  command, 
for  example,  can  bring  in  a  large,  complex  form  requiring  a  lot  of 
space . 

For  the  typical  PLOT,  the  buffers  should  be  adequate  to  hold  the 
entire  PLOT  PAGE. 

If  your  PLOT  is  particularly  dense  or  you  have  to  use  a  number  of 
FORMS,  then  you  should  plan  a  strategy  after  considering  the 
f ol lowi  ng . 

•  Can  you  divide  your  PLOT  into  more  than  one  PAGE?  The 
current  PLOT  PAGE  is  terminated  and  the  paper  is  advani^ed 
to  the  top  of  the  next  page  whenever  the  PAGE  command  is 
entered.  Thus  the  REQUEST  BUFFERS  are  cleared  and 
available  to  store  the  next  PAGE  requests. 

•  Can  you  divide  your  PLOT  PAGE  into  smallt>r,  more  manage- 
able SECTIONS?  The  CREATE  command  PR(X:es  terminates  the 
page  SECTION  and  causes  the  currently  stored  requests  in 
the  buffers  to  be  processed  into  plottable  data  for  out- 
put. The  buffer  is  then  cl(?ared,  and  becomes  available  to 
accept  requests  for  the  noxt  SECTION. 
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•  If  the  same  form  is  reused  on  the  PLOT  PAGE  (GETFRM 
Command),  consider  "Fixing"  the  form  into  memory  (GETFRM's 
FIX  option)  and  use  PUTFRM  to  place  the  form  at  the  dif- 
ferent page  positions  needed.  In  this  way,  the  FORMS 
graphic  contents  are  stored  only  once  instead  of  once  for 
each  position  where  the  FORM  is  needed. 

•  Can  you  make  use  of  the  REPEAT  command?  REPEAT  is  design- 
ed to  repeat  the  current  contents  of  the  REQUEST  BUFFERS 
up  to  approximately  32,000  times  in  the  vertical  direc- 
tion. No  additional  space  is  required  in  the  buffers. 
PAGES  are  recognized  and  the  line  printer  page  is  automat- 
ically advanced  by  the  TOP-OF-FORM  command  at  the  end  of 
each  page. 

2.5.4  To  Erase  Previously  Entered  Commands 

The  ERASE  command  can  be  us^d  to  clear  the  entire  REQUEST  BUFFER, 
but  not  an  individual  command.  For  this  reason,  a  strategy  of 
generating  PLOTS  in  a  series  of  smaller  SECTIONS  should  be 
considered  . 

2.5.5  To  Remove  a  Fixed  Form 

The  ERASE  command  is  the  only  way  to  do  this.  ERASE  has  an  "erase 
fixed  form  only"  option  (ERASE  FIX;  see  Appendix  A  descriptions). 

2.5.6  To  Get  Plot  Positioning  and  Other  Useful  Information 

The  SHOW  command  types  the  following  information  on  the  user's 
terminal  (refer  to  Section  A. 23  for  format). 

REFERENCE  position  (MOVRt/) 

GRAPHICS  POINTER  position 

PAGE  parameters  (SET PAG) 

FIGURE  parameters  (SETFIG) 

FORM  parameters  (GETFRM) 

2.5.7  To  Request  a  Summary  of  CREATE  Commands 
Type  HELP 
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APPENDIX  A 
CREATE  LISTING 


Appendix     A      is     an     alphabetical      listinq     of     the     CREATE     ccmmands 
including    format,    prompts,    options,    examples,    <ind    deac  r  i  pt  ions . 

A.l       BCODE 

Draw  a  CODE  39  barcode  from  a  specified  list  of  characters. 

Format ; 


BCODE  [List] 

Command  Options      Defaults 

/S  =  Size       /S  =  l.k)  or  value  assi)no<1  by 

SETFIJ  command 
/P  =  Number 

/I  '    x,y       Current  GRAPHIC  POINTER  position 
/A  =  x,y        Current  GRAPHIC  Point»jr  po-^iticn 


Prompts: 

ENTER  CHARACTERS:  List 

Command  Parameters: 

List  --  List  of  characters  are  represents  1  by  the  IiARCODE.  The 
list  of  characters  must  be  enclosed  In  quotation  marks. 
If  List  is  typed  with  the  BCODE  command,  •■  he  prompt  above 
is  bypassed. 


Legal  characters  are:     0-9 

A-Z 


$.*-/\ 


Descr  ipt Ion: 


The  BCODE  command  requests  to  draw  (or  plot)  a  list  of  characters 

in  CODE  39  barcode  format.   The  barcode  height  is  d»»termint'd  by 

the  internal  parameter  size  or  by  the  /3  commani  option.    The 

Initial  value  of  size  is  I. a  inch,  however,  this  value  can  Ic? 
changed  by  the  use  of  the  SETFIG  command. 

The  barcode  is  drawn  with  a  ratio  (wide  line  widths  to  thin  lln-* 
widths  and  wide  spaces  to  thin  spaces)  of  either  ^:l  or  ):1. 
These  ratios  are  dependent  on  the  value  of  the  internal  parameter 
RATIO.  RATIO  has  an  initial  value  of  2,  but  use  of  the  SETFIG 
command  can  change  the  value  tc  ]. 

A-l 


Barcode  text  can  be  printed  alcn^j  with  the  barTcde  fiju.e,  t>Jt  the 
barcode  hei-jht  is  shc^rtened  by  0.2  inch.  The  SETFIG  command  can 
be  used  t(j  delete  the  barccde  text  (OMIT  parameter)  whcfi  plcttin'j 
barcodes . 

The  barccde  I.t  inserted  at  the  current  GRAPHIC  POINTER  p<.iiiti(-n, 
starting  at  the  lower  left  corner  of  the  bar^'cde  rirjuro  itself. 
Upon  completion  of  the  BCODE  command,  the  GRAPHIC  P';iNTER  is  left 
at  the  lower  riiht  corner  of  the  fijure. 

Opt  ions : 

/A  =  x,y  The    GRAPHIC    POINTER    is    mc  ve  1     to    -i    new    location 

determined  b/  x  and  y,  that  are  defined 
relative  to  the  current  REFERENCE  ORIGIN 
before  the  insertion  of  the  blcck  charactets. 
Soth  X  and  y  are  decimal  numbers  oxpre^jsinq 
the  new  posit  i(;n  in  wh(  le  and/or  tenth  (  t  an 
inch    units. 

/I=x,y  The     GRAPHIC      POINTER      is     moved      a      ii stance, 

defined  by  x  and  y,  tc  a  new  position  betcro 
the  insertion  of  the  blcick  characters.  Both  x 
and  y  are  decimal  numbers  expressing  distance;; 
in    whole    and/or    tenth    inch    units. 

/P=n  This    option    assumes    that    CREATE     is     in    a    FORMS 

insertion  mode  Initiated  by  the  GETFRM  (or 
PUTFRM.  ccrr.mand  and  terminated  by  the  ENDFRi", 
PROCESS,      PAGE,      or      REPEAT     command.  A      LABEL 

POINT  "n"  on  the  current  form  is  accessed  and 
the  GRAPHIC  POINTER  is  moved  to  the  pcjsition 
detined  by  the  point.  The  "n"  is  an  Into'jer 
having    a    value    in    the    ranqe    from    1    tc    12. 

/S=Size  Draw    the     barcode    of     size     "Size".        Size     Is    a 

deci(\ial  number  expressing  the  barcode  height. 
in    whole    and/or    tenth   of    an    inch    units. 

Examples : 

1.       CRT>BC0DE/S=5.  0/1  =ri.i5,  1.1,5 
ENTER    CHARACTERS:     "ABCD" 

Generates    a    CODE  39    type    barcode    for    the    characters    ABCD.       The 

BARCODE    is    drawn  S .  f5    inches    high    at    a    positlc-n    6 .  v1     inches    d(iwn 

the    pan«3    (x)     and  l.H    inch    across    the    pa  )  e    (y)     (run    t  h<'    iurt'-nt 

GRAPHICS    POINTER  position. 


CRT>BCODE    "M/y/Z'/P^'j 


Generate    a    CODE     J9 

type 

the     cuirent      form's 

Sth 

above . ) 

barciide  for  the  characters  A1^3'/  at 
LABEL   POINT.     (See   /P  description 
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A.  2   BLOCK 

Draw  one  or  more  block  characters. 

Format: 


BLOCK  [character  list; 


Command   Opt 

ions 

/s 

= 

Si  ze 

/P 
/I 
/A 
/D 

£2 

Number 

x,y 
x,y 

Double 

Heig 

ht 

Defaults 

/S=1.0  or  value  assigned  by 

SETFIG  Command 


Current  GRAPHIC  POINTER  position 
Current  GRAPHIC  POINTER  position 
Height  =  Width  (Size) 


Prompcs! 

ENTER  CHARACTERS:  character  list 
Command  Parameters: 


character  list  — 


List  of  characters  are  displayed  as  BLOCK 
characters.  Character  List  must  be  enclosed  in 
quotation  marks.  The  above  prompt  is  bypassed 
if  the  Character  List  is  typed  on  the  same  line 
as  the  BLOCK  command. 


Legal  Characters  are: 


Description: 


0-9 
A-Z 


=  ?% 


The  BLOCK  command  makes  a  request  to  draw  (or  ^Jlot)  a  list  of 
characters  in  block  format.  Block  formatted  characters  are  drawn 
such  that  the  character  height  and  the  width  are  the  same  unless 
the  double  height  option  (/D)  is  specified.  For  double  height, 
the  character  height  is  twice  the  width.  The  character  width 
includes  intercharacter  spacing  on  the  character's  right  side 
which  is  one  sixth  of  the  total  width. 

Unless  the  size  option  (/S)  is  specified,  the  character  height  and 
width  is  determined  by  the  internal  parameter  by  the  same  name 
(size).  Initially,  size  has  the  value  of  1.0  inch,  however,  its 
value  may  be  changed  by  the  SETFIG  command. 

The  characters  are  inserted  at  the  current  GRAPHIC  POINTER 
position  starting  at  the  lower  left  corner  of  the  first  character. 
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Upon  completion  of  the  BLOCK  command,  the  GRAPHIC  POINTER  is  left 
at  the  last  character's  lower  right  corner  (including  the 
interchar acter    space). 

Options: 

/Size=Size  Draw  a  BLOCK  character (s)  of  size  "Size".   The 

default  value  for  Size  is  initially  1.0  (see 
3ETFIG  command). 

/D  Draw  character(s)   double  height.    Double 

height  can  be  used  in  conjunction  with  the 
other  BLOCK  options. 

/A=x,y  The  GRAPHIC  POINTER  is  moved  to  a  new  location 

determined  by  x  and  y,  which  are  defined 
relative  to  the  current  REFERENCE  ORIGIN 
before  the  insertion  of  the  block  characters. 
Both  X  and  y  are  decimal  numbers  expressing 
the  new  position  in  whole  and/or  tenth  inch 
un  its  . 

/I=x,y  The   GRAPHIC   POINTER   is   moved   a   distance 

defined  by  x  and  y,  ♦■.o  a  new  position  before 
the  insertion  of  the  block  characters.  Both  x 
and  y  are  decimal  numbers  expressing  distances 
in  whole  and/or  tenth  inch  units. 

/P=n  This  option  assumes  that  CREATE  is  in  a  forms 

insertion  mode  initiated  by  the  GETFRM  (or 
PUTFRM)  command  and  is  terminated  by  the 
ENDFRM,  PROCESS,  PAGE,  or  REPEAT  commands.  A 
LABEL  POINT  "n"  on  the  current  form  is 
accessed  and  the  GRAPHIC  POINTER  is  moved  to 
the  position  defined  by  the  point.  The  "n"  is 
an  integer  having  a  value  in  the  range  from  I 
to  12. 

Example  : 

1.   CRT>BLOCK/S=1.5/D/I=6.0, 1.0 
ENTER  CHARACTERS:   "BCP" 

The  block  characters  BCP  are  drawn  at  a  position  6.0  inches 
down  the  page  (x)  and  1.0  inch  across  the  page  (y)  from  the 
current  GRAPHICS  POINTER  position.  The  block  characters  are  a 
total  of  3.0  inches  high  since  the  size  option  was  set  for  1.5 
inches  and  the  double-height  option  was  specified. 
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A.  3   DBFFRM 

Initiate  FORM  GKNERATION  (or  definition) . 

Format: 


DEFFRM  [form  name  , height , width] 


Prompts: 

ENTER  FORM  FILE  NAME:   form  name 
ENTER  FORM  HEIGHT:   height 
ENTER  FORM  WIDTH:   width 

Command  Parameters: 


form  name  — 


height 


width 


Enter  a  form  name  of  1--27  characters.  The  form  name 
is  the  file  specified  for  the  disk  file  where  the 
form  is  stored.  (Refer  to  RSX-1 IM/M-P lus  MGR 
Operations  Manual,  Section  2.2.  or  VAXZVMS  CommancT 
Language  User's  Guide,  Chapter  2.)* 

Enter  the  desired  height  of  the  form  being  created. 
The  height  defines  the  lower  boundary  of  the  form 
when  inserting  the  form  graphics. 

Enter  the  desired  width  of  the  form  being  created. 
The  width  defines  the  right  boundary  of  the  form 
when  inserting  the  form  graphics. 


Description: 

The  DEFFRM  command  initiates  a  forms  definition  mode  of  operation 
where  the  user  may  enter  commands  describing  the  form  in  terms  of 
lines,  barcodes,  text,  and  block  characters.  These  commands  or 
requests  are  then  saved  for  later  use  on  a  disk  file.  The  form 
include  LABEL  POINTS  defined  by  the  DEFPNT  command.  When 
is  completed,  the  user  enters  the  SAVFRM  command  to  save 
and  its  contents  on  a  special  disk  file  created  for  this 


may  also 
the  form 
the  form 
purpose . 


Forms  can  not  be  defined  after  normal  plotting  is  started 

Options: 

None 


*  The  user  should  supply  the  .FRM  extension  to  the  form  name.  If 
a  name  is  given  without  an  extension,  the  system  supplies  the 
extension  .DAT, 
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Examples : 

1.  CRT>DEFFRM 

ENTER  FORM  FILE  NAME:  BCP.FRM 
ENTER  FORM  HEIGHT:   5 
ENTER  FORM  WIDTH:   5 

Defines  a  form  named  BCP.FRM  with  a  height  of  5.0  inches  and  a 

width  of  5.0  inches.   GRAPHICS  COMMANDS  (such  as  BLOCK,  BCODE, 

etc.)   can  be  entered  and  LABEL  POINTS  can  be  defined   (see 
DEFPNT)  at  this  time. 

2.  CRT>DEFFRM  FORM . FRM , 3 . 0 , 4 . 5 

Defines  a  form  named  FORM. FRM  with  a  height  of  3.0  inches  and 
a  width  of  4.5  inches. 
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A. 4   DEPPNT 
Format : 


I    DEFPNT  [Point  Number  ,dx  ,dy] 
I 


Prompts : 

ENTER  POINT  NUMBER  (i-12):  Point  Number 
ENTER  X  POSITION:  dx 
ENTER  Y  POSITION:  dy 

Command  Parameter: 

Point  Number    --    Enter  the  point  number  (1-12)  beinj  defined. 

dx  --    Enter   the  x  position   (relative  tct   the  form 

base)  of  the  LABEL  POINT. 

dy  --    Enter  the  y  positic^n  (relative  to  the  form 

base)  of  the  LABEL  POINT. 

Description: 

DEFPNT  defines  a  FORM  LABEL  POINT.  LABEL  POINTS  are  a  set  of  up 
to  12  predefined  locations  on  the  form  that  can  be  called  oat  by 
number  (1-12)  to  place  the  additional  --jraphics  at  form  insertion 
time.  DEFPNT  may  only  be  entered  while  in  the  FORMS  DEFINITION 
mode  (that  is  initiated  by  the  GETFRM  command  and  terminated  by 
the  SAVFRM  command)  . 

Options: 

None 

Example : 

1.       CRT>DEFPNT 

ENTER    POINT    NUMBER     (1-12):        2 
ENTER    X    POSITION:        1.5 
ENTER    Y    POSITION:        3. 2 

Defines  LAtJEL  POINT  number  2  at  a  position  l.b  inches  down  the 
form  (x)  and  3.2  inches  across  the  form  (y)  from  t.he  form's 
base    position    (upper    left    corner). 
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A. 5   END 

Terminate  current  plot 

Format : 


END 


I 


Prompts : 

None 

Command  Parameters; 

None 

Description : 

The  END  command  closes  a  plot  file  opened  by  the  NEWPLT  command. 
After  an  END  command,  CREATE  can  accept  a  NEWPLT  request  to  be<jin 
a  new  plot  or  an  EXIT  request  to  terminate  the  CREATE  program. 

Opt  ions : 

None 

Example : 

CRT>END 

The  END  command  terminates  the  current  plot.  At  this  p.int,  the 
user  can  exit  from  CREATE  or  Initialize  a  new  plot. 
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A. 6   ENDFRM 

Terminate  form  insertion. 

Format : 


ENDFRM 


Prompts : 

None 

Command  Parameters: 

None 

Descr  Ipt  ion : 

The  ENDFRM  command   terminates  form   insertion  !nni.> 
either  the  GETFRM  or  PUTFRM  command.   Once  ENDFRM  i^ 
FORMS  LABEL  POINT  can  no  longer  be  accessed. 

Options : 

None 
Example : 
CRT>ENDFRM 


i  n  i  t  i  .iL<vl   by 
entered,  the 


The  ENDFRM  command  termin^Jtes 
valid  only  after  the  GETFRM  or 


form  insertion. 
PUTFRM  command;;. 


Th  is  command   t : 
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A.  7   ERASE 

ERASE  commands  back  to  last  PROCES  or  NEWPLT  command. 

Format; 


I     ERASE  BUF 


Prompts: 

None 

Command  Parameters: 

BUF  —   Specifies  what  buffer  to  erase.   BUF  may  be  one  of  the 
following  three-character  words. 

•  FIX   —   Erase  a  form  fixed  in  memory. 

©   REQ   —   Erase  the  contents  of  the  REQUEST  BUFFER. 

•  ALL   —   Erase  both  the  contents  of  the  REQUEST 

BUFFER  and  a  form  fixed  in  memory. 

Description: 

The  ERASE  command  can  erase  a  form  fixed  in  memory,  the  current 
REQUEST  BUFFER,  or  both.  The  command  structure,  parameters,  and 
descriptions  of  each  are  listed  below. 

•  ERASE  FIX   —   Erases  a   form   fixed   in  memory   (see  the 

GETFRM/F  command)  .   ERASE  FIX  must  be  used 
before  another  GETFRM  command  can  be  used. 

•  ERASE  REQ   —   Erases  the  current  REQUEST  BUFFER  to  the 

last   PROCES,   PAGE,  or   REPEAT  command  or 
back  to  NEWPLT. 

•  ERASE  ALL   —   Erases  both  the  currenc  REQUEST  BUFFER  and 

the  form,  currently  fixed  in  memory. 

Options: 
None 


# 
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Examples: 

1.  CRT>ERASE 

The  ERASE  command  was  entered  with  no  parameters.  The 
default,  in  this  case,  is  to  ERASE  ALL;  for  example,  both 
the  contents  of  the  REQUEST  BUFFER  and  any  form  fixed  in 
memory  is  erased. 

2.  CRT>ERASE  FIX 

The  form  currently  fixed  in  memory  is  erased. 

3.  CRT>ERASE  REQ 

The  contents  of  the  current  REQUEST  BUFFER  (back  to  the 
last  PROCES,  PAGE,  or  REPEAT  command  or  back  to  NEWPLT) 
is  erased. 
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A. 8   EXIT 

Exit  program 

Format : 


I 

I  EXIT 


Prompts: 

None 

Command  Parameters: 

None 
Description t 

The  EXIT  command  terminates  the  CREATE  program. 

Options: 

None 

Example: 

CRT>EXIT 

This  causes  the  user  to  EXIT  from  the  CREATE  program 
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A.  9   GETFRM 

Retrieve  a  FORM  for  use. 

Format : 


GETFRM    [filename, xref,yre£] 

Defaults 


Command  Option 
/F 


NO  FIX 


Prompts: 

ENTER  FORM  NAME  (EX. BCP. FRM) :  filename 

ENTER  NEW  X  REFERENCE  POINT:  xref 

ENTER  NEW  Y  REFERENCE  POINT:  yref 

Command  Parameters: 

filename  —    Filename  of  the  FORM  being  retrieved. 


xref 


yref 


New  X   REFERENCE  point   where   retrieved   form   is 
placed . 

New  y  REFERENCE  point  where   retrieved   form   is 
placed  . 


Description: 


GETFRM  reads  a  stored  FORM  from  a  disk  file  and  inserts  it  in  the 
REQUEST  buffer  in  the  same  manner  as  a  normal  GRAPHIC  REQUEST  such 
as  BCODE.  In  addition,  GETFRM  initiates  a  FORMS  insertion  mode  of 
operation  that  permits  accessing  of  LABEL  POINTS  by  the  graphic 
commands  via  the  /P  option  (see  BCODE,  BLOCK,  TEXT,  etc.  command 
descr  ipt  ions) . 

The  FORMS  insertion  mode  is  terminated  by  one  of  the  following 
commands . 


Another  GETFRM  command 

ENDFRM 

PROCES 

PAGE 

REPEAT 

END 
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To  save  or  fix  the  FORM  contents  in  memory  for  shared  jse ,  the 
option  /F  can  be  used.  A  fixed  form  can  be  reused  for  any  number 
of  positions  on  the  paye  via  the  PUTFRM  command  from  a  sinqle  copy 
of  its  graphic  contents  stored  in  this  way. 

Whenever  a  FORM  is  fixed  into  memory,  another  GETFRM  cannot  be 
entered  until  the  FORM  is  removed.  A  fixed  form  is  removed  only 
by  the  ERASE  command  using  the  FIX  parameter. 

Options: 

/F  —   Fix  or  store  the  retrieved  form  in  memory  so  that  it 
can  be  used  repeatedly. 

Examples : 

1.  CRT>GETFRM/F 

ENTER    FORM    NAMK     (EX . BCP . FRM J  :     FORM.FRM 
ENTER    NEW    X    REFERENCE    POINT:     I.U 
ENTER    NEW    Y    REFERENCE    POINT:     3.0 

The  form  FORM.FRM  is  retrieved  and  fixed  in  memory.  It 
also  is  at  a  point  1.0  inch  down  the  page  (x)  and  0.0 
inch  across  the  page  (y).  The  PUTFRM  command  can  now  be 
used  to  make  any  number  of  additional  insertions  of  the 
form  on  the  plot  output.  Graphics  can  now  be  placed  at 
the  predefined  LABEL  POINTS  using  graphics  commands  with 
the    /P   options. 

2.  CRT>GETFRM    MVF ORM . FRM ,  3  ,  2/F 

The  form  MYFORM.FRM  is  fixed  in  memory.  MYFORM.FRM  is 
positioned  on  the  page  at  a  point  3.0  inches  down  and  2.0 
inches    across    the    page.      The    prompt    message    is    bypassed. 

3.  CRT>GETFRM  ABC. FRM, 1,1 

The  form  ABC.  FRM  is  pc^sitioned  at  the  new  REFERENCE 
position  1.0  inch  down  the  page  and  1.0  inch  across  the 
page.  The  form  is  not  fixed  in  memory.  The  prompt 
message  was  bypassed  since  the  desired  form  name  was 
entered  with  the  GETFRM  command. 
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A.  10   HDASH 

Draw  a  horizontal  dashed  line. 

Format : 


HDASH  [length] 

Command  Options  Def aui  ts 

/P=Namber 

/I=x,y  Current    GRAPHIC    PDINTER    position 

/A  =  x,y  Current    GRAPHIC    PGINTKR    posit  ion 

/T=Thlckness  Normal    dashed    line    thickness 


Prompts: 

ENTER  LENGTH:  length 

Command  Parameters: 

length  --  Desired  length  o£  the  line  in  inches.  The  prompt 
does  not  accept  a  carriage  return  since  there  is  no 
default  length  for  a  line. 

Description: 

The  HDASH  command  makes  a  request  to  draw  (or  plot)  a  horizontal 
dashed  line.   The  length  of  the  line  is  specified  by  the  user. 

The  lines  are  inserted  at  the  current  GRAPHIC  POINTER  po)sition. 

Upon  completion  of  the  HDASH  command,  the  IRAPHIC  POINTER  is  left 
at  the  end  of  the  line  or  the  lower  right  corner  of  a  thick  line. 

Opt  ions : 

/p--n  —  Place  the  line  at  the  current  FORMS  LABEL  POINT 
number  "n"  where  "n"  ringes  between  1  and  12.  This 
option  is  legal  only  iurinj  the  FORMS  insertion 
mode  (see  GETFRM) . 

/I="X,y     —    Place  the  line  at  an  incremental  distance  x,y  from 

the  current  GRAPHIC  POINTER  position. 

/A  =  x,y     —    Place  the  line  at  a  distance  x,y  from  the  current 

REFERENCE  and  update  the  GRAPHIC  POINTER  position 
to  this  po Int . 


A-15 


/T=Thickness 


Specify  the  desired  thickfiesr,  of  the  line. 
Thickness  can  range  from  H.l  inch  to  t\\n  limits 
of  the  paqe.  If  /T  is  not  called,  the  line 
defaults  to  a  thickness  of  one  dot  on  the 
printer/plotter    (a    normal    line). 


Examples : 


1.  CRT>HDASH/P=4/T=. 2 
ENTER  LENGTH:   4 

A  dashed  line  with  a  length  of  4.0  inches  and  a 
0.2  inch  is  entered  at  the  current  form's  4th 
(See  the  /P  description  above  for  restrictions.) 

2.  CRT>HnASH     3/1=1, 2. S 


thickness    of 
[.ABEL     POINT. 


A    dasned     line     with     a     length     of     3.0 
position     1.0     inch    down    (x      and    2 .  S     int 
current    GRAPHIC    POINTER    position. 

3.   CRT>HDASH  2 , b/A= 3 , 2/T= . 4 


inches  is  entered  at  a 
hes  across  (y)  from  the 


A  dashed  line  with  a  length  of  2.5  inches  and  a  thickness  of 
0.4  Inch  is  entered  at  a  position  3.0  inches  down  (x)  and  2.0 
inches  across  (y)  from  the  current  GRAPHIC  REFERENCE  position. 


• 
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A. 11   HELP 

Type  help  information. 

Format : 


HELP 


Prompts: 

None 

Command  Parameters: 

None 

Description: 

The  HELP  command  displays  the  file  HELPCR.DAT  at  the  user's 
terminal.  This  i^  an  abbreviated  help  file  showing  the  command 
string    format    and    the   options    used    with   each   command. 

Options: 

None 

Example: 

CRT>HELP 

A  HELP  file,  giving  the  command  format  and  the  listing  options  for 
each    command,    is    printed    at    the    screen    or    terminal. 
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A. 12   HLINE 

Draw  a  horizontal  line. 

Format : 


HLINE     [Length] 

Command  Qualifier 

/P=N 
/I=x,y 
/A=x,y 
/T=Thickness 


Defaults 


Current  GRACHIC  POINTER  position 
Current  GRAPHIC  POINTER  position 
Normal  line  thickness 


Prompts: 

ENTER  LENGTH:  Length 
Command  Parametars: 
Length    — 


Desired  length  of  the  line  in  inches.  The  promp 
does  not  accept  a  carriage  return  since  there  is  r 
default  length  for  a  line. 


Description : 


The  HLINE  command  makes  a  request  to  draw  (or  plot)  a  horizontal 
line.   The  length  of  the  line  is  specified  by  the  user. 

The  lines  are  inserted  at  the  current  GRAPHIC  POINTER  position. 

Upon  completion  of  the  HLINE  command,  the  GRAPHIC  POINTER  is  left 
at  the  end  of  the  line  or  at  the  lower  right  corner  of  a  thick 
line. 


Options: 
/P=n 

/I=x,y 
/A=x,y 


Place  the  line  at  the  current  FORMS  LABEL  POINT 
number  "n"  where  "n"  ranges  between  1  and  12.  This 
option  is  legal  only  during  the  FORMS  INSERTION 
MODE  (see  GETFRM  command) . 


Place  the  line  at  an  incremental  distance  x,y  from 
the  current  GRAPHIC  POINTER  position. 

Place  the  line  at  a  distance  x,y  from  the  current 
REFERENCE  and  update  the  GRAPHIC  POINTER  position 
to  this  point. 
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/T=Thickness      —      Specify     the     desired     thickness     of     the      line. 

Thickness  can  range  from  0.1  inch  to  the  limits 
of  the  page.  If  /T  is  not  called,  th'^  line 
defaults  to  a  thickness  of  one  dot  on  the 
printer/plotter     (a    normal    line). 

Examples: 

1.  CRT>HLINE/P=4/T=. 2 
ENTER  LENGTH:   4 

A  line  with  a  length  of  4.0  inches  and  a  thickness  of  0.2  inch 
is  entered  at  the  current  form's  4th  LABEL  POINT.  (See  the  /P 
description  above  for  restrictions.) 

2.  CRT>HLINE  3/1=1,2.5 

A  line  with  a  length  of  3.0  inches  is  entered  at  a  position 
1.0  inch  down  (x)  and  2.5  inches  across  (y)  from  the  current 
GRAPHIC  POINTER  position. 

3.  CRT>HLINE  2 . 5/A=3 , 2/T=. 4 

A  line  with  a  length  of  2.5  inches  and  a  thickness  of  0.4  inch 
is  entered  at  a  position  3.0  inches  down  (x)  and  2.0  inches 
across  (y)  from  the  current  GRAPHIC  REFERENCE  position. 
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A.  13   HTAB 

Move  the  REFERENCE  ORIGIN  horizontally  by  a  specified  number  ot 
TAB  increments. 

Format: 


I 

I  HTAB  [hnun] 


Prompts: 

ENTER  NUMBER  OF  HORIZONTAL  TABS:  hnun 
Command  Parameters: 

hnun       —    Number  of  horizontal  tabs  to  move  the  REFERENCE 

ORIGIN. 

Description: 

The  HTAB  command  moves  the  REFERENCE  ORIGIN  by  a  multiple  of  the 
horizontal  tab  distance  (TABH;  see  SETTAB  command)  across  the 
page.  The  distance  between  tabs  (set  by  the  SETTAB  command)  is 
checked  to  see  that  the  limits  of  the  page  are  not  violated  before 
moving  the  reference. 

Options : 

None 

Examples: 

1.  CRT>HTAB 

ENTER  NUMBER  OF  TABS:   5 

2.  CRT>HTAB   5 
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A. 14   MOVPTR 

Move  GRAPHIC  POINTER. 

Format : 


MOVPTR  [x,y] 


Prompts : 

ENTER  NEW  GRAPHIC  POINTER  X  POSITION:  X 
ENTER  NEW  GRAPHIC  POINTER  Y  POSITION:  y 

Command  Parameters: 

X   —   New  GRAPHIC  POINTER  X  position  is  at  coordinate  x. 

y   —   New  GRAPHIC  POINTER  Y  position  is  at  coordinate  y. 

Description: 

The  MOVPTR  request  moves  the  GRAPHIC  POINTER  position  x  inches 
down  the  page  and  y  inches  across  the  page  from  the  current 
REFERENCE  origin. 

Options : 

None 

Examples: 

1.  CRT>MOVPTR 

ENTER  NEW  GRAPHIC  POINTER  X  POSITION:  2 
ENTER  NEW  GRAPHIC  POINTER  Y  POSITION:  3.S 

The  GRAPHIC  POINTER  position  is  moved  to  the  point  2.H  incho:i 
down  the  page  (x)  and  3.5  inches  across  the  paje  (y)  from  th'i 
REFERENCE  ORIGIN. 

2.  CRT>MOVPTR    1.7,1.3 

Tho  GRAPHIC  POINTER  position  is  moved  to  thr  point  1.7  inches, 
down  the  page  (x)  and  1.3  inches  across  the  pa]e  (y)  from  fho 
REFERENCE  ORIGIN. 
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A. 15   MOVREF 

Reposition  REFERENCE  ORIGIN, 

Format : 


MOVREF  [x,y] 


Prompts: 

ENTER  NEW  REFERENCE  X  POSITION:  x 
ENTER  NEW  REFERENCE  Y  POSITION:  y 

Command  Parameters: 

X   --   New  REFERENCE  ORIGIN  X  coordinate. 

y   —   New  REFERENCE  ORIGIN  Y  coordinate. 

Description: 

The  MOVREF  request  moves  the  REFERENCE  ORIGIN  to  a  point  x  inches 
down  the  page  and  y  inches  across  the  page  from  the  PAGE  origin 
(absolute  0,0). 

Opt  ions : 

None 

Examples : 

1,  CRT>MOVREF 

ENTER  NEW  REFERENCE  X  POSITION:  ? . b 
ENTER  NEW  REFERENCE  Y  POSITION:  1 

The  REFERENCE  ORIGIN  is  repositioned  at  a  point  2.5  inches 
down  (x)  and  1.0  inch  across  ( y)  the  page  from  point  0 ,  kJ . 

2.  CRT>MOVREF  I,  1 

The  REFERENCE  ORIGIN  is  repositioned  at  a  jxiint  i.H  inch  down 
(x)  and  1.0  inch  across  (y)  the  page  from  point  0,0. 
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A.  16      NEWPLT 

tiep.ire    for    a    new   plot    output. 

b'j  rmat : 


NEWPLT  (File  name] 


t^  t  o  m  p  t  s  : 

KNTKR  FILENAME:  File  name 

Command  Parameters: 

File  name  --  File  name  is  any  legal  PDP~1  I  or  VAX/VMS  file 
specification  (such  as,  DH0:BCP.PLT)  for  tho 
graphics  file.  This  can  be  -iny  iej^il  file  name 
portion  of  the  specification  (for  'jxampl'',  HCP). 

Description: 

Trie  NEWPLT  request  opens  a  rew  file  for  plot  outputs  The  user  can 
specify  a  name  or,  by  answering  the  prompt  with  a  carriage  returri, 
can  choose  the  default  name  {3CP.PLT).  tf  the  user  choses  to 
specify  a  name,  the  extensicn  . PLT  should  be  used.  If  no 
extension  is  provided,  the  system  default  of  .DAT  is  provided. 

Opt  ions : 

None 
Examples : 

1.  i"RT>NEWPLT    BLOCK.  PLT 

A  file  named  BLOCK. PLT  is  opened. 

2.  CRT>NEWPLT 

ENTER  FILENAME:  GRAPH. PLT 

A  file  named  GRAPH. PLT  is  opened. 
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A.  17   PAGE 

Terminate  the  current  PLOT  page  and  start  a  new  page. 

Format: 


I  PAGE  i 

I I 

Prompts: 

None 

Command  Parameters: 

None 

Description: 

PAGE  causes  the  current  contents  of  the  REQUEST  BUFFERS  to  be 
processed  and  output.  Following  this,  an  LXY  "TOP-OF-FORM" 
character  is  output  to  the  printer.  The  PLOT  is  then  reinitial- 
ized to  the  top  of  the  next  page.  It  is  not  necessary  to  enter 
thr  PROCES  command  to  process  the  current  contents  of  the  REQUEST 
BUFFERS  before  PAGE. 

Example: 

CRT > PAGE 
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A.  18       PROCES 

Output    current    page    section. 

Format : 


•PROCES 


Prompts: 

None 

Command    Parameters: 

None 

Description: 

The  PROCES  command  is  used  to  force  the  Phase  2  processing  ot  the 
stored  REQUESTS  in  the  REQUEST*^  BUFFERS  into  plottible  data.  The 
plottable  data  is  stored  on  a  special  file,  called  the  graphics 
file,  for  later  transfer  to  the  LXV  printer  to  plot  the  graphii^s. 
The  PROCES  command  defines  the  SECTION  that  is  the  area  of  the 
page  covered  by  the  figures  defined  by  the  stored  REQUESTS.  The 
SECTION  height  is  determined  oy  the  height  of  the  resultant  he'gnt 
of  the  graphic  or  plotted  figures  defined  by  the  stored  REQUEST5. 
The  SECTION  height  is  adjusted  upwards  to    multiple  of  0.5  inch. 

Example: 

CRT>PROCES 
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A. 19   PUTFRM 

Reuse  a  "Fixed"  form  at  a  new  position. 

Format : 


PUTFRM  [xoff,  yoff) 


Prompts: 

ENTER  REFERENCE  OFFSET  IN  X:  xoff 
ENTER  REFERENCE  OFFSET  IN  Y:  yoff 

Command  Parameters: 

xoff   —   New  X  REFERENCE  offset  point  where  retrieved  form  is 
placed  . 

yoff   —   New  y  REFERENCE  offset  point  where  retrieved  form  i3 
placed . 

Description : 

PUTFRM  places  a  fixed  form  at  any  number  of  places  on  the  ouptut 
PAGE.  PUTFRM  cannot  be  used  unless  a  form  is  fixed  in  memory  {see 
GETFRM) . 

The  FORMS  insertion  mode  is  terminated  by  one  of  the  following 
commands . 

•  ENDFRM 

•  PROCES 

•  PAGE 

•  REPEAT 

•  END 

Whenever  a  FORM  is  fixed  into  memory,  it  must  be  removed  by  the 
ERASE  command  using  the  FIX  parameter  before  another  GETFRM 
command  can  be  used. 

Options: 

None 
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Examples: 

i.   CRT>PUTFRM 

ENTER  REFERENCE  OFFSET  IN  X:   4.0 
ENTER  REFERENCE  OFFSET  IN  Y:   1.0 

The  FORM  currently  fixed  in  memory  is  placed  at  a  point  4.0 
inches  down  the  page  (x)  and  the  1.0  inch  across  the  page  (y) . 
The  PUTFRM  can  be  used  to  make  any  number  of  additional 
insertions  of  the  FORM  on  the  plot  output. 

2.   CRT>PUTFRM  6,7 

The  FORM  currently  fixed  in  memory  is  inserted  at  a  point  6.0 
inches  down  the  page  (x)  and  7.0  inches  across  the  page  (y). 
"he  prompt  message  is  bypassed. 
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A.  20   REPEAT 

Output  the  graphics  requested  up  until  this  point.   Repeat  them  as 
speci  f ied . 

Format: 


I 

I  REPEAT     [hrep,yrep] 


Prompts: 

ENTER  NUMBER  OF  HORIZONTAL  REPEATS:  hrep 
ENTER  NUMBER  OF  VERTICAL  REPEATS:  vrep 

Command  Parameters: 

hrep   —   Number  of  horizontal  repeats  desired. 

NOTE 
TABH  (see  SETTAB)  must  be  set  before  REPEAT  is 
called . 

vrep   --   Number  of  vertical  repeats  desired. 

NOTE 
TABV  (see  SETTAB)  must  be  set  before  REPEAT  is 
called . 

Description: 

The  GRAPHIC  REQUESTS  currently  in  the  REQUEST  BUFFER  are  repeated 

hrep  times  horizontally  and  vrep  times  vertically.  REPEAT  calls 

on  the  PROCES  and  PAGE  facilities  as  needed  to  process  the 
requests  by  SECTION  and  to  advance  the  PLOT  PAGE. 

The  requests  are  repeated  at  intervals  that  are  defined  by  the 
system  TAB  parameters  (horizontal  and  vertical)  that  can  be  set  up 
by  the  SETTAB  command. 

NOTE 
It  is  important  for  the  user  to  set  up  appro- 
priate values  for  TABH  and  TABV  by  entering 
the  SETTAB  command.  The  value  for  TABV  must 
be  a  multiple  of  0.5  inch  when  used  with 
REPEAT. 
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Options: 

None 
Example: 

CRT>REPEAT  3,2 

Repeats  graphics  in  current  REQUEST  BUFFER  J  (four  actual  entries) 
times  across  the  page  and  2  (three  actual  entries)  times  down  the 
page  (actual  total  of  12  entries)  using  the  spacing  set  up  by  the 
SETTAB  command. 
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A. 21   SAVFRM 

Terminate  form  generation. 

Format : 


SAVFRM  I 

I 


Prompts: 

None 

Command  Parameters: 

None 

Descr  ipt  ion : 

The  SAVFRM  request  terminates  FORM  OKFINITION  and  writes  the 
contents  of  the  REQUEST  eUFFER  onto  the  FORM  file  for  later  use  by 
the  GETFRM  command.  This  command  is  valid  only  after  the  DEFFRM 
command . 

Options : 

None 

Example: 

CRT>SAVFRM 

Terminate  the  FORM  being  generated  by  DEFFRM. 


9 


^P 
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A. 22   SETFIG 

Sec  up  default  figure  parameters. 

Format : 


SETFIG  [size, ratio ,dbht, omit] 


Prompts: 

ENTER  CHARACTER  SIZE:   size 

ENTER  BARCODE  RATIO  (2  OR  3):  ratio 

DO  YOU  WANT  DOUBLE  HEIGHT  FIGURES  (Y/N):  dbht 

DO  YOU  WANT  TO  OMIT  BARCODE  TEXT  (Y/N):  omit 

Command  Parameters: 

size   —   Set  the  character  size. 

ratio  —   Set  a  barcode  ratio  of  2  (2:1)  or  3  (3:1). 

dbht*  —  Set  double-height  figures.  Default  is  a  regular 
height,  where  both  character  height  and  width  are 
equal  to  the  value  of  "size". 

omit*  —   Omit  barcode  text  beneath  barcode. 

Description: 

The  SETFIG  command  provides  the  user  with  a  means  to  change  the 
system  figure  parameters  used  for  block  character  and  barcode 
generation.  When  the  BLOCK  and  BCODE  commands  are  entered,  and 
the  /S  option  is  not  used,  the  figure  size  used  is  the  system 
figure  size.  When  the  BLOCK  command  is  entered,  and  the  /D  option 
is  not  used,  the  value  of  the  dbht  is  used  by  the  software.  RATIO 
and  OMIT  are  used  to  determine  the  format  of  barcode. 

Options: 

None 


*If  anything  other  than  "Y"  is  entered,  it  is  taken  as  a  no 
answer . 
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Examples: 

1.  CRT>SETFIG 

ENTER  CHARACTER  SIZE:  1.5 

ENTER  BARCODE  RATIO  (2  OR  3):  3 

DO  YOU  WANT  DOUBLE  HEIGHT  FIGURES  (Y/N):  Y 

DO  YOU  WANT  TO   OMIT  BARCODE  TEXT  (Y/N):  Y 

2.  CRT>SETFIG  3,2,N,N 
Where : 

3  —  Sets  the  default  character  size  to  3.0  inch. 

2  —  Sets  the  default  barcode  ratio  to  2:1. 

N  —  (NO)  Figure  is  regular  height  instead  of  double  height 

N  —  (NO)  Text  is  included  with  all  barcodes. 
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A. 23      SETPAG 
Format : 


I  SETPAG     [length, width, evfu] 


Prompts: 

ENTER  PAGE  LENGTH:  length 

ENTER  PAGE   WIDTH:  width 

DO  YOU  WANT  TO  BYPASS  THE  EVFU  (Y/N):   evfu 

Command  Parameters: 

length   —   Page  length  for  limit  checks  and  PAGE  command  use. 

When  EVFU  UNIT  is  used,  LENGTH  cannot  be  greater  than 

22.0  inches,  and  mast  be  expressed  to  the  nearest  0.5 

inch  increment. 

width   —    Page  width  for  limit  checks.    Resolution  0.1   inch 
(13.2  1 imit)  . 


up 


evfu    —    Logical  flag.   If  evfu  is  Y  (TRUE),  bypass  is  set 

(if  anything  other  than  "Y"  is  typed,  the  answer  is 
set  to  NO) . 


Description: 

The  LXY  PRINTER/PLOTTER  has  a  facility  called  EVFU  that  is  set  up 
by  the  BCP  software.  EVFU  determines  how  far  the  paper  is  to 
advance  when  a  "TOP-OF-FORM"  is  received,  either  mechanically  by 
the  "TOP-OF-FORM"  switch  or  by  BCP  software.  The  BCP  software 
sets  up  the  unit  according  to  the  page  length  (LENGTH),  so  that 
when  the  PAGE  command  is  entered,  the  paper  advances  up  to  the 
distance  set  for  LENGTH  (depending  on  how  far  the  PLOT  is  down  the 
page)  . 

Options: 

None 
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Examples: 

1.  CRT>SETPAG  7.5,10.,N 

The  page  length  is  set  to  7.5  inches  and  the  width  is  set  to 
10.0  inches.   EVFU  is  not  bypassed. 

2.  CRT>SETPAG 

ENTER  PAGE  LENGTH:  24 

ENTER  PAGE   WIDTH:  13.2 

DO  YOU  WANT  TO  BYPASS  THE  EVFU  (Y/N):  Y 

The  page  length  is  set  to  24.0  inches,  therefore,  the  EVFU 
must  be  bypassed.   The  width  is  set  to  13.2  inches. 
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A.  24   SETTAB 

Set  up  tab  distance  parameters. 

Format : 


I  I 

I         SETTAB   [tabh,tabvl  | 

I I 

Prompts: 

ENTER  HORIZONTAL  TAB  DISTANCE:  tabh 
ENTER  VERTICAL  TAB  DISTANC'E:  tabv^ 

Command  Parameters: 

tabh   —   Set  the  distance  for  horizontal  tabs. 

tabv   —   Set  the  distance  for  veritcai  tabs.   Must  be  multiple  of 
0.5  inch  when  used  with  REPEAT. 

Description: 

The  SETTAB  request  sets  the  spacing  intervals  between  horizontal 
and  vertical  tabs.  The  length  between  tabs  cannot  go  beyond  the 
current  page  limits.   These  TAB  parameters  are  later  used  to: 

•  Move  the  REFERENCE  ORIGIN  by  these  intervals  (TABV,  TABH) 
whenever  the  Tab  command  is  used,  and 

•  Set   up   REPEAT   intervals  both  horizontally   (tabh)   and 
vertically  (tabv),  for  use  by  the  REPEAT  command. 

Options : 

None 

Examples: 

1.  CRT>SETTAB 

ENTER  HORIZONTAL  TAB  DISTANCE:  4.5 
ENTER  VERTICAL  TAB  DISTANCE:  3.0 

Horizontal  tabs  are  set  across  the  page  every  4.5  inches. 

Vertical  tabs  are  set  down  the  page  every  3.0  inches.  (NOTE: 

This  command  must  be  called  before  calling  the  REPEAT 
command . ) 

2.  CRT>SETTAB  2,2 

Horizontal  tabs  are  set  across  the  page  at  2.0  inch  intervals. 
Vertical  tabs  are  set  down  the  page,  also  at  2.0  Inch 
I ntervals . 
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A.  25   SHOW 

Type  current  values  o£  system  parameters, 

Format : 


I         SHOW  [Type] 


Prompts : 

None 

Command  Parameters: 

Type  ; 

The  parameter  types  are  as  follows. 

POS  —  Position  parameters 

P' G  —  Page  parameters 

FIG  --  Figure  parameters 

FOR  —  Form  parameters 

ALL  --  All  parameters 

NOTE 
If  no  Type  is  entered,  SHOW  defaults  to  SHOW 
ALL. 


Where  : 


POS  returns 


REFERENCE  ORIGIN... X,Y 
CURRENT  POSITION. . .X,Y 
CURRENT  SECTION. . .X 


PAG  returns: 


PAGE     LENGTH 
PAGE    WIDTH 
TABV    DISTANCE 
TABH    DISTANCE 


FIG    returns 


CHARACTER  SIZE 

DOUBLE  HEIGHT  (Y/N) 

RATIO  (2,3) 

OMIT  BARCODE  TEXT  (V/N) 
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FOR  returns? 

FORM  WIDTH 

FORM  LENGTH 

12  FORM  LABEL  POINT  POSITIONS  (X,Y  VALUES) 

ALL  returns: 

ALL  THE  ABOVE 

Descr  ipt  ion : 

The  SHOW  command  displays  current  and  defjuit  [).i  r  imet  o  r  s .    SHOW 
has  five  parameters  listed  and  described  below. 

SHOW  POS   —   Position  parameters 
SHOW  PAG   —  Paqe    parameters 
SHuW  FIG   —   Figure  par:^meter3 
SHOW  FOR   —   Form  parameters 

SHOW  ALL   --   All   of   the   above   parameters   (in   the   order 
1 isted) 

Opt  ions : 

None 
Examples : 

1.  CRT>SHOW 

SHOW  defaults  to  SHOW  ALL.   A  list  of  all  the  above  parameters 
is  shown. 

2.  CRT >S HOW  POS 

Th  5  position  parameters  are  displiyei. 
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A. 26   TEXT 

Print  0.1  inch  block  characters. 

Format : 


TEXT  [List  of  characters] 


Command  Options 

/P=N 

/I=X,Y 

/A=DX,DY 


Defaults 


Current   GRAPHIC    POINTER   position 
Current   GRAPHIC    POINTER    position 


Prompts: 

ENTER  TEXT:  List  of  characters 

Command  Parameters: 

List  of  characters  —  Character  list  enclosed  in  double  quota- 
tion marks  that  have  a  printed  heiqht  of 
0.1  ' nch. 

Description: 

The  TEXT  command  allows  the  user  to  insert  a  list  of  standard  text 
characters  0.1  inch  high  on  the  PLOT  PAGE. 

Options: 

/P  =  n 

/I=x,y 
/A=dx  ,dy 


Place  the  character  list  at  the  current  FORMS  LABEL 
POINT  "n"  where  "n"  ranges  between  1  and  12.  This 
option  is  legal  only  during  the  FORMS  INSERTION  mode. 

Place  the  character  list  at  an  incremental  distance 
X,y  from  the  current  GRAPHIC  POINTER  position. 

Place  the  character  list  at  a  distance  x,y  from  the 
current  REFERENCE  and  update  the  GRAPHIC  POINTER 
position  to  this  point. 
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Examples: 


CRT>TEXT 

ENTER  TEXT:  "BARCODE  SOFTWARE" 

The  Character  List  "BARCODE  SOFTWARE"  is  printed  at  the 
current  POINTER  position. 

CRT>TEXT  "BCP"/P=4 

The  Character  List  "BCP"  is  printed  at  the  current  form's  4th 
LABEL  POINT. 

CRT>TEXT  "TEST  1234 "/I =4, 2 

The  Character  List  "TEST  1234"  is  printed  at  a  position  4.0 
inches  down  the  page  (x)  and  2.0  inches  across  the  page  (y) 
from  the  current  GRAPHIC  POINTER  position. 
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A. 27   VDASH 

Draw  a  vertical  dashed  line. 

Format: 


VDASH    [length] 


CoRimand   Options 

/P=N umber 
/I=x,y 
/A=x,y 
/T=Thickness 


I 


Defaults 


Current  GRAPHIC  POINTER  position 
Current  GRAPHIC  POINTER  position 
Thin  dashed  line 


Prompts: 

ENTER  LENGTH:  length 

Command  Parameters: 

length  —  Desired  length  of  the  line  in  inches.  the  prompt  does 
not  accept  a  carriage  return  since  there  is  no  default 
length  for  a  line. 

Description : 

The  VDASH  command  makes  a  request  to  draw  (or  plot)   a  vertical 
dashed  line.   The  length  of  the  line  is  specified  by  the  user. 

The  lines  are  inserted  at  ':iie  current  GRAPHIC  POINTER  position. 

Upon  completion  of  the  VDASH  command,  the  GRAPHIC  POINTER  is  left 
at  the  end  of  the  line  or  the  lower  right  corner  of  a  thick  line. 


Options: 
/P=n 

/I=x,y 
/n=x,y 


Place  the  line  at  the  current  form's  LABEL  POINT 
number  "n"  where  "n"  ranges  between  1  and  12.  This 
option  is  legal  only  during  the  FORMS  INSERTION 
mode  (see  GETFRM  command) . 

Place  the  line  at  an  incremental  distance  x,y  from 
the  current  GRAPHIC  POINTER  position. 

Place  the  line  at  a  distance  x,y  from  the  current 
REFERENCE  and  update  tlje  GRAPHIC  POINTER  position 
to  this  point. 
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/T=Thickness  Specify  the  desired  thickness  of  the  line. 
Thickness  can  range  from  0.1  inch  to  the  limits  of 
the  page.  If  /T  is  not  called,  the  line  defaults 
to  a  thickness  of  one  dot  on  the  printer/plotter  (a 
normal    1 ine)  . 

Examples : 

1.  CRT>VDASH/P  =  4/T=.  2 
ENTER  LENGTH:   4 

A  dashed  line  with  a  length  of  4.0  inches  and  a  thicknesi;  of 
0.2  inch  is  entered  at  the  current  form's  4th  LABKL  POINT. 
(See  the  /P  description  above  for  restrictions.) 

2.  CRT>VDASH  3/1=1,2.5 

A  dashed  line  with  a  length  of  3.0  inches  is  entered  at  a 
position  1.0  inch  down  (x)  and  2.5  inches  across  (y)  from  the 
current  GRAPHIC  POINTER  position. 

3.  CRT>VDASH  2. 5/A=3 , 2/T= . 4 

A  dashed  line  with  a  length  of  2.5  inches  and  a  thickness  of 
0.4  inch  is  entered  at  a  position  3.0  inches  down  (x)  and  2.0 
inches  across  (y)  from  the  current  graphics  REFERENCE 
position. 
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A. 28   VLINE 

Draw  a  vertical  line. 

Format: 


VLINE    [length] 


Command   Quali£iers 

/P=NLimber 
/I=x,y 
/A=x,y 
/T=Thickness 


Default 


Current  GRAPHIC  POINTER  position 
Ccrrent  GRAPHIC  POINTER  position 
Normal  width  dashed  lino 


Prompts : 

ENTER  LENGTH:  length 

Command  Parameters: 

length  —  Desired  length  of  the  line  in  inches.  The  prompt  does 
not  accept  a  carriage  return  since  there  is  no  default 
length  for  a  lin^. 

Description: 

The  VLINE  command  makes  a  request  to  draw  (ot  plot)  a  vertical 
line.   The  length  of  the  line  is  specified  by  ':he  user. 

The  lines  are  inserted  at  the  current  GRAPHIC  POINTER  position. 

Upon  completion  of  the  VLINE  command,  the  GRAPHIC  POINTER  is  left 
at  the  end  of  the  line  or  the  lower  right  corner  of  a  thick  line. 


Options : 
/P  =  n 


/I=x,y 
/A=x,y 


Place  the  line  at  the  current  FORMS  LABEL  POINT 

number  "n"  where  "  n"  ranges  between  1  and  12.   Th  i  ;•. 

option  is  illegal  when  entered  before  the  GETFRM 

command  or  after  the  ENDFRM  command. 


Place  the  line  at  an  incremental  distance  x,y  from 
the  current  GRAPHIC  POINTER  position. 

Place  the  line  at  a  distance  x,y  from  the  current 
REFERENCE  and  update  the  GRAPHIC  POINTER  position 
to  th  is  po  int . 


A-42 


/T=Thickness  Specify  the  desired  thickness  of  th.^  line. 
Thickness  can  range  from  0.1  inch  to  the  limits  of 
the  page.  If  /T  is  not  called,  the  line  jefaults 
to    a    thickness   of    one  "dot    on    the    printer/plotter. 

Examples : 

1.  CRT>VLINE/P=4/T  =  .  2 
ENTER    LENGTH:        4 

A  line  with  a  length  of  4.0  inches  and  .j  thickness  of  0.2  inch 
is  entered  at  the  current  form's  4th  LABEL  POINT.  (See  the  /P 
description  above  for  restrictions.) 

2.  CRT>VLINE  3/1=1,2.5 

A  line  with  a  length  of  3.0  inches  is  entered  at  a  position 
1.0  inch  down  (x)  and  2.5  inches  across  (y)  from  the  current 
GRAPHIC  POINTER  position. 

3.  CRT>VLINE  2 . 5/A= 3 , 2/T=4 

A  line  with  a  length  of  2.5  inches  and  a  thickness  of  0.4  inch 
is  entered  at  a  position  3.0  inches  down  (x)  and  2.0  inches 
across  (y)  from  the  current  graphics  REFERENCE  position. 


A -4  3 


A.  29   VTAB 

Move  the  REFERENCE  ORIGIN  vertically  by  a  specified  number  a f  TAB 
i  ncrements . 

Format : 


VTAB   [Vnum] 


Prompts : 

ENTER  NUMBER  OF  VERTICAL  TABS:  Vnum 

Command  Parameters: 

Vnum   —   Number  of  vertical  tabs  to  move  the  REFERENCE  QRI'JIN. 

Descr  ipt  ion : 

The  VTAB  command  moves  the  REFERENCE  ORIGIN  by  a  multiple  of  the 
vertical  tab  distance  (TABV;  see  SETTAB  command)  across  the  pi  }•-' . 
The  distance  between  tabs  (set  by  the  SETTAB  commani)  is  checKel 
to  see  that  the  limits  of  tr.e  pa^e  are  not  violated  before  movinj 
thi^  reference. 

Opt  ions • 

None 

Examples : 

1.  CRT > VTAB 

ENTER  NUMBER  OF  VERTICAL  TABS:   5 

2.  CRT>VTAB   5 
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APPENDIX  B 
GLOSSARY 


EVFIJ 


FORM  BASE 


LXY  printer/plotter's  electronic  vertical 
forms  unit.  This  unit  is  set  up  ./ith  the  page 
length  (or  form  feed  length)  and  is  used  to 
advance  the  LXY  paper  to  the  next  physical 
page  . 

A  point  on  the  FORM  boundary  (upper  left 
corner)  that  is  aligned  to  the  RKFERENCE 
ORIGIN  at  the  time  of  form  insertion  (see 
GETFRM,  Appendix  A,  Section  A. 9).    All  FORM 

GRAPHICS  and  LABEL  POINTS  are  stored  on  the 

FORMS   file   with  the   position   (X  ind  Y) 

expressed  relative  to  the  FORM  BASE  on  the 
fo  rm , 


FORMS 


GRAPHIC  FIGURES 


GRAPHIC  POINTER 


A  collection  of  GRAPHIC  COMMANDS  or  REQUESTS 

that  can  be  saved  and  later  called  to  recreate 

a  plotted  output.   Additional  graphic  data  can 

be  inserted  into  the  form  at  the  time  of 
actual  output. 

Any  plotted  figures  generated  by  the  BCPLIB 
routines  (such  as  barcodes,  block  character, 
lines,  etc .) . 

This  is  insertion  position  on  the  PLOT  PAGE 
for  graphic  figures  (such  as  barcodes,  block 
characters,  lines,  etc.). 


GRAPHIC  REQUEST 


This  is  the  stored  (or  buffered)  data  that 
occurs  when  the  user  calls  on  the  BCP  software 
to  draw  something  such  as: 

•  To  the  system  operator  (or  CREATE  user). 
This  is  the  result  of  entering  a  graphic 
figure  command  (BCODE,  BLOCK,  TEXT,  VLINE, 
HLINE,  VDASH,  HDASH,  DEFFRM,  PUTFRM)  or, 

•  To  the  system  programmer  (or  BCPLIB  user) . 
This  is  a  result  of  calling  one  of  the 
GRAPHIC  SUBROUTINES. 


LABEL  POINTS 


A  set  of  offset  points  (defined  at  form  crea- 
tion time)  defined  relative  to  the  FORM  BASE. 
LABEL  POINTS  can  later  be  referenced  to 
position  variable  GRAPHIC  FIGURES  for 
insertion  at  the  time  of  actual  plot  output. 
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PAGE  (PLOT  PAGE)     The   PAGE   (or   PLOT   PAGE)   is   the   external 

equivalent  of  Lhe  LXY  PRINTER/PLOTTER  page. 
The  PAGE  length  and  width  is  adjustable  to 
match  the  PRINTER/PLOTTER  page  length  and 
width. 

REQUEST  A  general  term  for  GRAPHIC  REQUEST.   This  also 

includes  all  nongraphic  figure  CREATE  commands 
and  BCPLIB  subroutine  calls  (such  as  MOVREF, 
MOVPTR,  etc.) . 

SECTION  A  variable  sized  pc>rtion  of  the  output  page. 

The  plot  data  may  be  output  by  a  sequence  of 
PAGE  SECTIONS  instead  of  whole  PAGES  (this  is 
usually  done  when  there  are  too  many  GRAPHIC 
REQUESTS  to  buffer  for  the  entire  PAGE). 
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APPENDIX  C 
ERROR  MESSAGES 


• 


C.l   WARNINGS 

+  2  REQUEST  BUFFER  NEARLY  FULL  —  This  Wcirninq  messa'je 
occurs  when  five  or  fewer  storage  packets  remain  in  the 
request  pool. 

C.2   ERROR 

-  100      GRAPHIC   FILE  WRITE   ERROR   —  This   error   occurs   when 

writing  plot  information  on  the  GRAPHICS  FILE.  The 
REQUESTS  for  this  SECTION  are  lost  and  the  plot  must  be 
restarted.  Check  for  device  problems  (such  as  disk 
full,  device  offline,  etc.). 

-  101      CANNOT  1^''.,N  GRAPHIC  FILE  —  This  happens  while  trying  to 

initialize  or  open  a  file  for  graphic  output  and  an 
error  condition  occurs.  It  is  impo.  ^ible  to  continue 
with  the  current  plot.  Check  for  device  problems  (such 
as  disk  full,  device  off-line,  illegal  UIC,  etc.). 

-  10:2  GETFRM      -     ERROR     CLOSING      FORMS      FILE      —      The      FORMS      file 

following  the  contents  of  the  defined  form  may  be  lost. 
Check  for  device  problems  (such  as  disk  full,  device 
o  f f-1 ine  ,  etc  . )  . 

-  103      ILLEGAL  ARGUMENT   (PARAMETER)   SPECIFIED  —  One  of   the 

parameters  supplied  by  the  user  is  illegal  (such  as 
characters  in  a  numeric  field).   Reenter  the  request. 

-  104      GETFRM  -  CANNOT  OPEN  FORMS  FILE  —  The  program  cannot 

open  the  FORM  file  requested  by  the  DEFFRM  request. 
This  happens  if  the  form  was  not  saved  (SAVFRM)  at  the 
time  of  definition,  if  the  form  name  was  misspelled,  or 
if  device  problems  occurred  (such  as  off-line,  write 
locked  device,  etc.) . 

-  105      GETFRM  -  FORMS  FILE   READ  ERROR   —  This  error   occurs 

while  reading  the  FORMS  file  as  a  result  of  the  GETFRM 
request.  Check  for  device  problems  (such  as  disk  full, 
device  off-line,  etc.). 

-  106      DEFFHM   -  CANNOT  CREATE   FORM   FILE   —  A   FORM   File   was 

initialized  (or  opened)  in  response  to  a  DEFFRM  request 
and  an  error  occurred.  Check  for  device  problems  (such 
as  illegal  device,  device  off-line,  etc.). 
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-  107      DEFFRM  -  FORMS  FILE  WRITE  ERROR  —  Error  occurred  while 

trying  to  write  on  the  FORMS  file  folicwin^  the  UEFFK^. 
request.  The  contents  of  the  currently  defined  form  ;n,iy 
be  lost.  Check  for  device  errors  (such  as  wr  i te-lockcd 
device,  device  off-line,  etc.). 

-  108      SAVFRM  -  ERROR  CLOSING  FORMS  FILE  —  This  error  occurs 

while  trying  to  close  the  FORMS  file  foll^-iwing  the 
SAVFRM  request.  The  contents  of  the  currently  define(i 
form  may  be  lost.  Check  for  device  problems  (such  d>s 
device  off-line,  write-locked  device,  etc.)  . 

-  109      X  LIMIT  FAILURE  (SECTION)  —  The  current  request   (TAR, 

MOVREF,  GETFRM,  or  PUTFRM)  defines  a  reference  in  the 
previous  PAGE  SECTION  (or  PAGE).  If  a  PAGE  SECTION  or 
PAGE  was  processed,  any  further  requests  to  draw  qr^phi'..- 
figures  or  part  of  a  figure  in  that  PAGE  SECTION  -.  r  PAGE 
cannot  be  accepted. 

-  110      X  OR  y  LIMIT  FAIL  -  jUTSIDE  PAGE  BOUNDARTKS  --  The  X  ..r 

Y  parameter  requested  was  outside  the  page  bouniiaries. 
Type  SHOW  PAGE  to  view  the  current  default  [)age 
bo  undar  ies . 

-  Ill      FORM  DEFINITION  -  X  OR  Y  OUTSIDE  FORM  BOUNDARIES  —  This 

error  occurs  only  during  the  forms  definition  mode.  The 
current  REQUEST  (BCODE,  BLOCK,  TEXT,  etc.)  defines  pi 
figure  whose  area  extends  beyond  the  limits  defined  by 
the  DEFFRM  REQUEST. 

-  112      X  OR  Y  LIMIT  FAIL  -  OUTSIDE  REFERENCE  BOUNDARIES  —  The 

X  or  Y  parameter  requested  was  outside  the  reference 
boundaries.  Type  SHOW  POS  to  view  the  current  default 
REFERENCE  ORIGIN. 

-  113      Unused. 

-  114      REQUEST   BUFFER   FULL   —   No   GRAPHIC   REQUESTS   can   be 

accepted  until  Phase  2  processing  is  initiated.  The 
current  REQUEST  was  aborted.  Use  the  PROCES,  PAGE, 
REPEAT,  FINISH  (CREATE  END)  REQUEST  to  continue. 

-115      CANNOT  CHANGE  FIGURE  PARAMETERS  WHILE  PLOT  IN  PROGRESS 

—  It  is  illegal  to  make  a  SETFIG  request  once  plotting 

starts  (this  is  following  any  graphic  figure  request 
such  as  BCODE,  BLOCK,  TEXT,  etc.). 

-  116      PUTFRM  -  NO  FORM  FIXED  IN  MEMORY  -  A  form  must  be  fixed 

in  memory  with  GETFRM/F  before  PUTFRM  can    be  requested. 


-  il7      GETFRM  -  FORM  ALREADY  FIXED  IN  MEMORY  —  Once  a  form  is 

fixed  in  memory  the  user  cannot  request  another  form 
(GETFRM),  fixed  or  not  fixed.  The  user  must  request 
ERASE  FIX  before  another  GETFRM  REQUEST  can  be  made. 

-  118      SETPAG   -   X   LIMIT   BEYOND   EVFU   CAPABILITY   —   The   LXY 

PRINTER/PLOTTER  EVFU  facility  has  a  maximum  form  length 
of  22.0  inches  (in  the  X  direction) . 

-  L19      ILLEGAL  REQUEST  SEQUENCE  —  The  DEFFRM  request  cannot  be 

made  at  this  time  because  the  system  is  already  in  the 
FORM  definition  mode  or  because  plotting  is  already  in 
prog  ress . 

-  121      SAVFRM   -   FORM   NOT   BEING   DEFINED   —   A   term   must   be 

defined  (DEFFRM)  before  it  can  be  saved. 

-  122      CANNOT  PROCESS  PLOT  SECTION  WHILE  DEFINING  A  FORM  —  The 

PLOT  section  cannot  be  processed  (PROCES  or  REPEAT 
request)  while  a  form  is  being  defined. 

-  123      Unused. 

-  124      FORM  INSERTION  -  X  OR  Y*  FORM  LIMIT  VIOLATION  —  Limit 

violation  occurred  while  in  the  form  insertion  mode 
(GETFRM  by  PUTFRM  requests)  .  The  area  covered  by  the 
defined  figure  (resulting  from  a  GRAPHIC  REQUEST  such  as 
BCODE,  BLOCK,  etc.)  extends  beyond  the  current  FORM 
limits.  The  REQUEST  is  aborted.  To  continue,  either 
make  an  ENDFRM  REQUEST  or  resposition  the  figure. 

-  125      Y   LIMIT  SPECIFIED   IS  BEYOND   LXY  CAPABILITY   --  The  Y 

parameter  requested  is  beyond  the  13.2  inches  the  LXY  is 
capable  of  handling. 

-  126      X  LIMIT  IS  NOT  A  MULTIPLE  OF  0.5  INCH  —  The  X  parameter 

requested  must  be  a  multiple  of  0.5  inch.  PAGE  or  VTAB 
lengths  (SETPAG)  must  be  expressed  in  ^)  .  5  inch 
i  ncrements . 

-  127      PLOT  NOT   INTIALIZED  —  The   PLOT  must   bt;   initialized 

before  any  requests  can  be  entered.  Use  the  CREATE 
NEWPLT  command  or  the  BCPLIB  I N IT  subroutine  to 
initialize  the  PLOT. 

-  128      PLOTTING   IN   PROGRESS:   CANNOT  RESET   PAGE   PARAMETERS   -- 

You  cannot  make  a  SETPAG  REQUEST  once  plotting  starts 
(this  is  following  any  graphic  figure  'c-quest  such  as 
BCODE,  BLOCK,  TEXT,  etc.). 
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-  129      PLOT  IS  ALREADY  INITIALIZED:  CANNOT  BE  REINITIALIZED  -- 

A  PLOT  was  already  initialized  and  is  currently  in  uso  . 
If  a  new  plot  file  is  needed,  the  current  plot  file  must 
be  terminated  by  the  CREATE  user's  END  command  or  BCPLIB 
user's  FINISH  request.  After  a  FINISH  (END)  request,  a 
new  plot  can  be  initialized. 

-  130      Unused. 

-  131      REQUEST  BUFFER  EMPTY,  NO  OUTPUT  POSSIBLE  —  ■\     PROCES  or 

REPEAT  REQUEST  was  made,  but  the  REQUEST  BUFFERS  were 
empty . 

-  132      REPEAT  -  TAB  HEIGHT  SMALLER  THAN  HEIGHT  W     GRAPHICS  — 

The  heighc  requested  with  VTAB  is  smaller  than  the 
height  of  the  graphics  to  be  repeated.  The  current  VTmB 
parameters  can  be  viewed  by  typing  SHOW  PAG. 

-  133      ILLEGAL  USE  OF  GETFRM  OR  PUTFRM.    MUST  TERMI.ATE  WITH 

ENDFRM. 

-  134      CANNOT  USE  "MOVREF"  REQUEST  DURING  FORM  INSERTION. 

-  135      GETFRM   -  CANNOT  FIX  A  FORM  WHILE   DEFINING  A  FORM   -- 

During  the  form  definition  mode,  a  form  cannf  t  be  fixed 
in  memory. 

-  136      CREATE  COMMAND  ERROR 

-  137      GETFRM  -  FIXED  FORM  DOES  NOT  CONTAIN  GRAPHIC  DATA 

-  333      UNRECOGNIZED  ERROR  —  This  can  be  caused  by  a  program 

"bug"  or  a  memory  error. 
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PART    XI 
BCPtIB     (GRAPHICS    LIBRARY)     USER'S    GUIDE 


CHAPTER  1 
INTRODUCTION 


1.1   GENERAL  DESCRIPTION 

The  Barcode  and  Block  Character  Plotter  (BCP)  software  package 
generates  both  barcode  and  block  character  printing  on  an  LXY 
PRINTER/PLOTTER.  Using  an  interactive  user  program  and  a  library 
of  graphic  routines,  the  BCP  software  package  can  produce: 

•  CODE  39  barcode, 

•  Block  characters, 

•  Horizontal  and  vertical  lines, 

•  Horizontal  and  vertical  bars  (thick  lines), 

•  Horizontal  and  vertical  dash  lines,  and 

•  0.1  inch  text  characters. 
Typical  uses  include  the  creation  of: 

•  Rhipping  and  identification  labels, 

•  Forms, 

•  Signs,  and 

•  Inventory  and  accounting  documents. 

1.2   OVERVIEW 

The    BCP    software    package     is    made    up    of    two     components,     each     de- 
signed   for    a   different    user. 

•  CREATE  is  an  interactive  program  for  .ne  nontechnical 
user.  CREATE  is  built  on  the  foundation  provided  by 
BCPLIB  and  gives  the  user  an  on-line  graphics  generation 
capability    for    use    in    the    production    environment. 

•  BCPLIB  (BCP  Graphic  Utility  Library)  is  available  for  the 
technical  user  or  programmer  experienced  in  writing 
computer  software.  BCPLIB  is  a  library  of  software 
building  blocks  that  serves  as  a  foundation  fur  the 
graphics  applications.  It  provides  graphic  facilities  for 
both    user    application    software    and    the    BCP   CREATE    Program. 

There    are    two    front-ends     (or    ways)     into    the    BCP    software     (Figures 
1-1    and    1-2).      The    front-ends    are    either    through    the: 
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•  Interactive    CREATE    program,    or 

•  Optional    user    application    program. 

Both  of  these  programs  are  biiilt  upon  BCPLIB,  with  each  accepting 
commands  from  a  system's  tr-rminal.  These  front-encis  pa.:.'3  the 
command  information  on  tu  BCPLIB.  This  command  information  is 
called  the  GRAPHIC  REQUEST.  GRAPHIC  REQUESTS  are  processed  by 
BCPLIB  in  two  phases  due  to  physical  limitations  placed  on  the 
program  (such  as  LXY  PRINTER/PLOTTER  paper  movement  and  computer 
memory)  . 

Phase    1 

During  this  phase,  the  GRAPHIC  REQUESTS  are  accepted,  evaluated, 
and  stored  (buffered)  into  a  special  area  of  the  program's  space 
in  computer  memory  called  the  REQUEST  BUFFER. 

Phase  2 

Phase  2  is  entered  as  a  result  of  a  special  request  (or  CREATE 
command)  such  as  the  PROCES  request.  During  this  phase,  the 
requests  in  the  buffer  are  processed  into  plottable  information, 
which  is  then  written  or  temporarily  stored  in  the  GRAPHICS  FILE, 
and  is  later  transferred  to  the  LXY  PRINTER/PLOTTER. 

Phases  1  and  2  can  be  repeated  alternately,  until  an  entire  plot 
(which  may  be  more  than  one  page  of  output)  is  completed. 

Once  the  plot  is  completed,  the  contents  of  the  GRAPHICS  FILE  can 
be  transferred  directly  to  the  LXY  PRINTER/PLOTTER  via  the 
following  methods. 

•  For  RSX-llM  —  Use   the   MCR   utility   PIP    (or   PRINT 
f  acil  ity)  . 

•  For  VAX/VMS  —  Use  the  PRINT/NOFEED  command. 

1.3   BCP  SOFTWARE  CONCEPTS 

This  section  explains  the  concepts  that  must  be  understood  in 
order  to  use  the  BCP  software.   They  are: 

•  PLOT  PAGE, 

•  SECTION, 

•  FORMS,  and 

•  LABEL  POINTS. 
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PLOT  PAGE 

The  PLOT  PAGE  is  the  basic  unit  of  plot  output.  It  is  an  internal 
software  equivalent  of  the  LXY  PRINTER/PLOTTER  page.  Since  the 
PRINTER/PLOTTER  paper  can  be  of  different  lengths  or  widths,  the 
PAGE  boundaries  can  also  be  adjusted  internally  to  match  the 
PRINTER/PLOTTER  PAGE  SIZE.  When  GRAPHIC  REQUESTS  are  received  by 
the  software,  the  dimensions  of  the  figures  are  checked  to  see  if 
they  fit  within  the  nage  boundaries.  GRAPHIC  (or  plottable) 
information  can  be  generated  for  more  than  ore  page,  but  each  page 
is  treated  individually  and  terminated  by  a  "TOP-OF-FORM"  paper 
movement.  The  "TOP-OF-FORM"  movement  positions  the  paper  to  the 
top  of  the  next  physical  page. 

SECTION 

It  a  lot  of  GRAPHIC  REQUESTS  are  required  to  generate  a  plot,  the 
REQUEST  BUFFER  could  overflow  before  the  output  page  is  complete. 
To  prevent  this.  Phase  2  of  the  GRAPHIC  REQUEST  may  be  triggered 
at  any  time  and  the  requests  received  up  tc  that  time  are 
processed.  The  area  of  the  page  covered  by  the  graphic 
information  in  the  REQUEST  BUFFERS  determines  the  page  SECTION. 
Once  a  SECTION  is  processed,  no  more  graphic  input  is  accepted 
that  has  any  part  falling  within  the  range  of  that  SECTION. 
Following  the  output  of  that  SECTION,  a  new  SECTION  is  defined  by 
updating  the  SECTION  origin  position  to  the  start  of  the  unused 
part  of  the  page.  The  REQUEST  BUFFERS  have  a  capacity  that  can  be 
exceeded  by  the  number  of  GRAPHIC  REQUESTS,  graphic  data  should  be 
entered  in  a  top-to-bottom  sequence.  However,  for  most  plots,  the 
REQUEST  BUFFER  is  adequate  to  store  the  graphics  for  the  entire 
page.   SECTIONS  are  defined  and  written  as  the  result  of  the: 

•  PROCES  request, 

•  END  request ,  and 

•  REPEAT  request. 

FORMS 

The  BCP  FORMS  facility  provides  a  means  for  the  user  to  generate 
the  fixed  portion  of  a  graphic  output  (such  as  labels  and  business 
forms)  and  store  it  for  later  use.  This  means  that  the  fixed  part 
of  a  graphic  output  must  be  generated  only  once.  When  proilucing 
the  final  output,  the  user  can  merge  the  fixed  portion  with  the 
variable  part  of  the  graphic  output.  FORMS  «.  in  be  created  during 
the  Phase  1  process  of  the  GRAPHIC  REQUEST.  Graphic:  requests 
defining  the  FORM  are  processed  in  the  same  way  as  a  normal 
output.  Phase  2  processing  is  bypassed  and  on  the  completion  of 
the  FORM,  a  special  request  is  called  to  reformat  the  contents  of 
the  REQUEST  BUFFERS  and  write  the  requests  on  the  FORMS  file. 


1-5 


Once  a  FORM  is  created,  it  can  be  repeatedly  recalled  during 
software  production  runs  by  referencing  its  name.  FORM^  ai'^. 
called  in  a  similar  manner  to  standard  graphic  figures  such  ai 
barcodes.  When  a  FORM  is  called,  the  FORM  :>ase  ir,  aligned  with 
the  REFERENCE  ORIGIN  (Section  1.4)  position  on  input.  The  FORM 
data  is  read  from  the  FORM  file,  reformatted,  and  .itcrej  in  the 
REQUEST  BUFFER  like  any  standard  figure.  The  variible  portion  of 
the  FORM  can  be  inserted  at  this  time  by  making  additional  GRAPHIC 
REQUESTS. 

A  FORM  can  be  used  to  define  another,  more  ccunpLex  FO!\M .  ^  FORM 
can  also  be  fixed  into  memory  for  repeated  use.  Not  (.-nly  doe:; 
this  save  I/O  activity  on  the  FORM  file,  but  a  -.ingle  image  ot  the 
FORMS  graphics  may  be  stored  for  any  number  of  different  positions 
of  the  FORM  on  the  plot  page,  thus  saving  REQUEST  BUFFER  .-ipace. 

LABEL  POINTS 

LABEL  POINTS  are  used  as  an  aid  in  the  positioning  of  the  variabl'? 
portion  of  FORMS  during  production  runs.  LABEL  POINTS  are  a  S(.'t 
of  up  to  12  predefined  positions  on  the  FORM  which  are  selected  by 
number  (1  through  12)  to  position  the  variable  graphics.  The  X 
and  Y  values  associated  with  each  LABEL  POINT  arn  offset  (or 
incremental)  distances  from  the  FORM  base.  The  FORM  base  is 
aligned  with  the  REFERENCE  ORIGIN  (Section  1.4)  when  the  FORM  is 
requested  and  the  LABEL  POINTS  then  become  GRAPHIC  POTNTER 
(Section  1.4)  positions  on  the  PLOT  PAGE.  By  requesting  a  LABEL 
POINT  by  number,  the  user  causes  the  GRAPHIC  POINTER  to  be  moved 
to  the  position  indicated  (by  the  LABEL  POINT)  and  additional 
graphic  input  can  then  be  added. 

1.4   BCP  SOFTWARE  COORDINATE  SYSTEM 

To  aid  in  the  placement  of  the  graphic  figures  on  the  PLOT  PAGE 
(see  Figures  1-3  and  1-4),  the  BCP  software  proviles  a  .;oo  r 'i  i  nate 
system  that  is  defined  as: 

•  PAGE  ORIGIN, 

•  SECTION  ORIGIN, 

•  REFERENCE  ORIGIN,  and 

•  GRAPHIC  POINTER. 

PAGE    ORIGIN 

Upper  left-hand  corner  of  the  physical  line  printer  pap-jr.  This 
is    plot    (or    absolute)     position    {i),<A). 

The  ABSCISSA  X  is  defined  as  beinn  the  vertic-il  direction  starting 
from  the  PAGE  ORIGIN,  increasing  in  value  to  the  braiom  of  the 
page.  Thus,  the  positive  X  direction  corresponds  with  the  paper 
movement  and  maintains  a  right-handed  coordinate  system.  The 
resolution    is    0.1    inch. 
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The  ORDINATE  Y  is  defined  as  being  the  horizontdi  direction 
starting  from  the  PAGE  ORIGIN,  increasing  in  value  to  the 
right-hand    side    of    the    page.       The    resolution    is    0.1    inch. 

SECTION  ORIGIN 

This  is  the  starting  position  of  the  current  page  section.  The  V 
coordinate  is  always  0  and  its  X  coordinate  (XS)  is  an  offset 
distance  from  the  PAGE  origin.  The  SECTION  ORIGIN  affects  the 
user  by  becoming  the  lower  limit  for  the  X  coordinate  on  his 
GRAPHIC  REQUESTS.  Initially,  the  SECTION  ORIGIN  starts  at  the 
PAGE  origin  which  is  3,0.  As  sections  are  processed,  it  advances 
by  the  section  height  to  define  the  start  of  the  next  section. 

REFERENCE  ORIGIN 

This  is  a  moveable  coordinate  system  within  the  PAGE.  Graphic 
figures  are  placed  c^n  the  PAGE  with  respect  to  the  REFERENCE  ORI- 
GIN (Xr,Yr).  The  X  and  Y  position  for  the  figures  are  f.ffset 
distances  from  this  point.  The  REFERENCE  ORIGIN  is  moved  by 
specifying  new  values  for  the  Xr  and  Yr  offsets  from  the  PAGE 
origin.  ThJ  REFERENCE  ORIGIN  is  a  mechanism  to  provide  position 
independence  (with  respect  to  the  PAGE)  for  the  graphic  figures  on 
the  PAGE.  This  is  an  important  mechanism  in  processing  FORMS  and 
REPEAT  requests. 

The  Xr  value  of  Iv.e  REFERENCE  ORIGIN  must  not  be  smaller  than  the 
SECTION  origin.  A<;  the  PAGE  sections  are  processed,  the  REFERENCE 
ORIGIN  is  advancoi^  auto.nat  icfl  I  1  y  with  the  SECTION  origin. 

GRAPHIC  POINTER 

Current  position  for  graphic  data  entry  is  expressed  as  an  offset 
Xc  and  Yc  from  the  REFERENCE  ORIGIN.  Neither  Xc  nor  Yc  may  take 
on  negative  values  (for  example,  cannot  be  smaller  than  the 
REFERENCE  ORIGIN)  . 

1.5   GRAPHIC  OUTPUT  ON  THE  LXY  PRINTER/PLOTTER 

The  LXY  PRINTER/PLOTTERS  place  physical  limitations  on  the  BCP 
software  operation.  The  PRINTER/PLOTTERS  can  only  accept 
plottable  data  (raster  data)  one  raster  line  (a  line  thickness  ot 
one  dot,  0.01"i9  inch)  at  a  time  in  a  top-of-page  to  bo  t  tom-o  f-page 
and  page-by-page  sequence. 

The  LXY  PRINTER/PLOT'.;-.-^  paper  moves  only  in  a  forward  direction, 
so  that  all  graphic  )  itput  must  be  coordinated  with  the  printing 
movement  of  the  paper.  The  plot  data  must  be  sorted  and  written 
on  the  PRINTER/PLOTTER  one  raster  line  at  a  time  in  a  sequence 
acceptable  to  the  PRINTER/PLOTTER.  This  places  restrictions  on 
the  sequence  of  GRAPHIC  REQUESTS  entries  by  the  user.  As 
mentioned  in  Section  1.3,  the  BCP  software  sorts  the  stored 
requests  according  to  physial  position  cin  the  PAGE.  Also,  the  BCP 
software  can  only  accept  graphic  input  in  Cifder  according  to  PAGE. 
The  restrictions  to  the  order  of  graphic  input  on  the  PAGE  depends 
on  the  number  of  requests  and  PAGE  SECTIONS. 
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1.6      BCPLIB  GRAPHICS  PLACEMENT 

1.6.1  Inserting  Forms  on  the  PLOT  PAGE 

FORMS  are  inserted  on  the  PLOT  PAGE  at  the  current  REFERENCE  ori- 
gin (Figure  1-3).  The  REFERENCE  ORIGIN  coincides  with  the  FORM 
BASE.  The  FORM  graphics  are  drawn  from  this  point  down  the  page 
(an  increasing  value  of  X)  until  the  FORM  length  (FLIMX)  is 
reached.  In  the  same  way,  the  FORM  is  drawn  across  the  page  until 
the  FORM  (FLIMY)  width  is  reached. 

The  FORM  LABEL  POINTS,  being  offset  valuers  from  the  FORM  BASE,  now 
become  GRAPHIC  POINTER  values. 

The  REFERENCE  origin  is  moved  in  one  of  several  ways.  It  may  be 
moved : 

•  As  the  result  of  entering  the  TAB  request  (for  example, 
VTAB  or  HTAB  commands  for  the  CREATE  user  or  a  call  to  the 
TAB  subroutine  for  the  BCPLIB  user), 

•  As  the  result  of  entering  the  MOVREF  request, 

•  As  the  result  of  entering  the  GETFRM  and  PUTFRM  requests 
These  requests  contain  X  and  Y  parameters  to  reposition 
the  REFERENCE  origin  prior  to  the  actual  form  insertion, 
or 

•  As  the  result  of  action  taken  at  the  completion  of  the 
PAGE,  PRINT,  and  REPEAT  requests.  The  REFERENCE  ORIGIN  is 
moved  to  the  new  PAGE  or  SECTION  origin  according  to  the 
request . 

1.6.2  Inserting  Graphic  Figures  on  the  PLOT  PAGE 

NOTE 
Sufficient  space  (in  both  height  and  width) 
must  be  made  available  for  the  graphic  figure 
that  is  to  be  drawn.  The  GRAPHIC  POINTER 
positron  (Xc,  Yc)  must  be  chosen  so  that 
enough  space  in  height  and  width  is  available 
to  draw  the  graphic  figure. 

All  graphic  figures  are  inserted  into  the  PLOT  PAGE  at  the  cur- 
rent GRAPHIC  POINTER  position.  Figure  1-4  illustrates  how  the 
figure  is  placed  using  the  block  Character  A  as  an  example.  The 
GRAPHIC  POINTER  (Xc,  Yc)  is  assumed  to  be  on  the  lower  left  cor- 
ner of  the  figure,  which  is  then  drawn  upward  on  the  page  (a  de- 
creasing X  direction)  until  reaching  the  figure  height  and  to  the 
right  by  its  width  (SIZE). 

The  new  position  of  the  GRAPHIC  POINTER  is  then  set  to  the  lower 
right  corner  figure  plus  an  intercharacter  space  (Xce,  Yce) .  The 
user  should  be  cautioned  that  before  placing  the  fiqure  on  the 
PLOT  PAGE,  the  X  values  for  the  GRAPHIC  POINTER  positi~on  (Xc,  Yc) 
must  be  at  least  as  great  as  the  figure  height  (SIZE). 
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For  the  LINES  (VLINE,  VDASH,  HLINE,  HDASH),  the  direction  is  im- 
plicit in  the  subroutine  argument  LENGTH  which  may  have  either  a 
positive  or  negative  value. 

The  GRAPHIC  POINTER  is  moved  in  one  of  several  ways.  It  may  be 
moved : 

•  As  the  result  of  entering  a  MOVPTR  request, 

•  As  the  result  of  entering  a  request  to  draw  any  graphic 
figure  (BLOCK,  BCODE,  TEXT,  etc.).  Each  graphic  figure 
request  includes  parameters  to  reposition  the  GRAPHIC 
POINTER  before  actual  figure  insertion, 

•  As  the  result  of  any  request  that  moves  the  REFERENCE 
ORIGIN  (Section  1.4).  Whenever  the  REFERENCE  ORIGIN  is 
moved,  the  GRAPHIC  POINTER  is  reset  to  0,0, 

•  As  the  result  of  action  taken  upon  completion  of  the 
graphic  figure  requests  (BLOCK,  BCODE,  etc.).  BLOCK, 
BCODE,  and  TEXT  leave  the  POINTER  at  the  end  of  the 
character  list  plus  the  interchar acter  space  (1/6  of  the 
character  width),  or 

•  As  LINES  (VLINE,  HLINE,  VDASH,  HDASH)  leave  the  pointer  at 
the  end  of  the  line. 
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CHAPTER  2 
BCP  UTILITY  LIBRARY  (BCPLIB)  OVERVIEW 


This  chapter  describes  the  use  of  the  BCP  utiiity  {BCPLI3)  facili- 
ties to  generate  graphic  (plot)  output  from  a  user  application 
proq  ram . 

2.1   INTRODUCTION 

The  BCP  utility  library  (BCPLIB)  consists  of  '-jraphi^-  modules 
(subroutines)  that  provid-^  a  graphic  foundation  for  th-e  user's 
application  program.  These  subroutines  make  up  an  objects  library 
designed  to  be  linked  with  the  user  application  program  at  TASK 
bui  id  time . 

The  BCP  library  consists  of  th.ree  main  parts. 

•  Preprocessing  of  Graphic  Requests  ■--  This  is  the  first 
phase  in  the  two-phase  ooiuence  requ'red  to  process 
GRAPHIC  REQUESTS.  For  Phase  1  the  user  application 
program  makes  the  following  types  of  requests  (subroutine 
call  statements^. 

Initialize  the  system  for  a  new  plot  output  and  open 
the  g  raph  ic' s  file. 

Optionally  change  the  default  value  of  certain  system 
parameters  (such  as  page  parameters,  figure 
par  ameter  s  ,  etc  . ) 

Enter  GRAPHIC  REQUESTS  such  as  LINES,  BARCODE,  BLOCK 
CHARACTERS,  etc. 

Optionally  define  forms. 

•  Tables  and  Buffers  —  The  final  product  urom  Phase  1  is 
the  storage  or  queuing  of  the  GRAPHIC  REQUESTS  collected 
so  far  for  Phase  2  processing.  The  incoming  GRAPHIC 
REQUESTS  are  verified  for  validity,  refoimatted,  and  then 
stored  in  special  REQUEST  BUFFERS  for  later  Phase  2 
process  ing  . 

•  Postprocessing  of  the  GRAPHIC  REQUESTS  —  The  user's 
application  program  can  trigger  the  Phase  2  or 
postprocessing  activity  by  call  in)  on  one  of  the  following 
rout Ines . 

--  PROCES 

—  FINISH 

—  PAGE 

—  REPEAT 
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During  Phase  2,  the  queued  REQUESTS  are  processed  by  the  graphic 
algorithms  into  plottable  (rasterized)  data,  that  is  written  on 
the      GRAPHICS      FILE.  The      plottable      data      is      generated      by      the 

algorithms  in  the  order  of  the  LXY  PRINTER/PLOTTER  physical  paper 
movement  (using  the  plot  mode  facility).  In  this  way,  the  qraphii^ 
figures  are  generated  simultaneously,  according  to  their  physical 
position  on  the  output  page,  one  raster  line  at  a  time.  Later  the 
GRAPHICS  FILE  can  be  directly  transferred  lo  the  LXY 
PRINTER/PLOTTER  via  the  system  utility  PIP  (or  PRINT  ^ACILIT^)  for 
RSX-UM    BCP   or    the    PRINT/NOFEED    command    for    VAX-ll    BCP. 

2.2       USING    THE    BCPLIB    ROUTINES 

Basically,  there  are  four  types  of  subroutines  in  the  BCP  library 
(refer  to  Appendix  A  for  a  list  and  description  of  these  rou- 
tines). See  Figure  2-1  for  overlaying  possibilities  for  the 
BCPLIB    routines     (kSX-llM    BCP    only)  . 

•  Plot    Control    Routines 

INIT/INI  Initialize    for    a    new    plot. 

FINISH  Terminate    the    current    plot. 

—  PROCES  Process    the    current    PAGE    SECTION 

REPEAT  Repeat     the     contents     of     the     REQUEST 

BUFFERS. 

—  SETPAG  Change  the  values  for   the  default 

page  parameters. 

—  SETTAB  Change  the  values  for  the  tabulation 

parameters. 

ERASE  Erase  or  cancel  queued  requests. 

EXAM  Examine  specified  system  variables 

and  parameters. 

•  Plot  Positioning  Routines 

--  MOVPTR  Move    the    graphic    pointer. 

—  MOVREF  M<^ve    the    referencp"    origin. 

—  l'AGE  Advance    to    the    nnxt    plot    page. 

—  TAB  Move    tne    REFERENCK    <1UGT.N    vi<'    t .ibn  . 
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Figure  2-1   Overlay  Guide  (RHX-llM  BCP) 


Graphic    Figure    Routines 


BCODE 

BLOCK 

TEXT 

HDASH 

HLINE 

VDASH 

VLINE 


Draw  a  barcode. 

Draw  block  character/s. 

Draw  text. 

Draw  a  horizontal  dash  line. 

Draw  a  horizontal  solid  line. 

Draw  a  vertical  dash  line. 

Draw  a  vertical  solid  line. 


Form  Routines 


DEFFRM 
SAVFRM 
DEFLBL 
GETFRM 
GETLBL 
ENDFRM 


Define  a  form. 
Terminate  form  definition 
Define  a  form  label  point 
Insert  a  predefined  fotm. 
Get  a  form  label  point. 
Terminate  form  insertion. 


2.2.1   Status  Arguments 

Most  BCPLIB  subroutine  CALL 
STATUS.    STATUS  returns  to 
describes  the  action  taken 
(for   example,   request), 
character  ist  ics . 


statements  include  an  argument  called 
the  user  program  a  special  code  that 

as  the  result  of  the  subroutine  CALL 
The  code  has   the   following  general 


STATUS 


STATUS 


+N 


+  1 


Warning  --  The  request  was  honored 
However,  a  situation  exists  that  the'' 
caller   should   be   aware   of.    The 
value  of  N  identifies  the  situation 
( see  Append  ix  C)  . 

Nf^'^al  or  successful  return. 


•  STATUS   =    -N        Error  --  The  error  is  identified  by 

the  numeric  value  of  N.   The  request 
was  aborted.   Appendix  C  lists  all! 
error  codes. 

2.2.2   Format  of  Graphic  Figure  Routines 

Each  of  the  GRAPHIC  ENTRY  routines  have  three  forms  or  variations. 
The  variation  specifies  how  the  GRAPHIC  FIGURE  is  to  be  positioned 
on  the  PLOT  PAGE.  Each  GRAPHIC  subroutine  name  consists  of  a 
basic  five-character  name  and  an  optional  one-character  suffix. 
The  suffix  character  (or  lack  of  a  suffix  character)  determines 
the  variation. 

•  No  Suffix  Character  --  Place  the  figure  at  an  offset 
(incremental)  distance  from  the  current  GRAPHIC  POINTER 
po  s  i  t  i  o  n  . 
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Example; 

CALL  BLOCK  (N ,  LIST,  DHT,  DX,  DY ,  SIZE,  STATUS) 

The  block  characters  in  the  array  list  are  to  be  drawn 
starting  at  an  offset  DX,  DY  from  the  current  GRAPHIC 
POINTER  position. 

•  P  Suffix   —   Place  the  figure/s  at  the  specified  FORM 
LABEL  point. 

Example: 

CALL  3L0CKP  (N ,  LIST,  DHT,  P,  SIZE,  STATUS) 

The  argument  "P"  identifies  the  Idbel  point  (1-12). 

•  A  Suffix   —   Move  the  GRAPHIC  POINTER  to  a  new  position 
(X,Y)  before  placing  the  current  figure. 

Example : 

CALL  BLOCKA  (N,  [,IST,  DHT,  X,  Y,  SIZE,  STATUS) 

The  arguments  X  and  Y  specify  the  new  position  of  the 
GRAPHIC  POINTER,  and  hence,  the  insertion  point  for  the 
characters  in  LIST. 

2.3   GUIDELINES  FOR  USING  BCPLIB  TO  GENERATE  PLOTS 

The  following  nine  steps  outline  the  sequence  and  general  rules 

for  PLOT  generation  using  BCPLIB. 

la.   Either  to  start  a  new  plot   —   Call  the  INIT  subroutine. 

Example: 

CALL    INIT     CBCP.PLT',    4,     STATUS) 

Comments ; 

All  plots  must  start  with  a  call  to  INIT. 

To  proceed  from  here; 

Following  the  call  to  INIT,  you  may  proceed  with  any  step 
that  follows,  except  for  Steps  5  and  6. 

lb.   Or  to  initialize  for  FORM  definition  only    —    Call   the 
alternate  entry  INI. 

Example; 

CALL  INI  (STATUS) 
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Comments; 

You  may  only  define  FORMS  following  this  call. 

2.  To  change  the  values  of  certain  internal  paramoters   —   Call 
one  or  more  of  the  follciwing  routines. 

•  SETPAG   —   To  change  the  PAGE  LIMITS,  etc. 

•  SETFIG   —   To  change: 

Default  block  character  and  barcode  size; 

Default  barcode  ratio  flag; 

Default  block  character,  double-height  flag;  and/or 

Default  barcode  text  flag. 

•  SRTTAB    —    To   change   the  values  of   the   vertical   and 
horizontal  TAB  distance. 

Comments: 

•  These  are  optional  subroutine  calls. 

•  SETPAG  and  SETFIG  can  only  be  called  at  tt.ls  time. 

•  SRTTAB  may  be  entered  at  any  time  following  the   call    to 
'MIT  (or  INI) . 

•  SETTAB  sets  up  the  repeat  intervals  for  the  REPEAT  routine. 
To  proceed  from  here : 

Proceed  to  Step  3  or  4.    If  the  subroutine  call  was  made  to 
SETTAB  only,  proceed  to  Step  7. 

3.  To  define  a  form   —   Enter  the  DEFFRM  and  DEFPNT  commands. 

Example ; 

CALL  DEFFRM  (  .^ORM.FRM',  5.0,  6.2,  STATUS) 
CALL  DEFLBL  (1,1.0,  2.0,  STATUS) 
CALL  DEFLBL  (2,  1.5,  2.5,  STATUS) 

o  o  o 
CALL  HLINE  (5.0,  0.0,  ^1.0,  0.,  STATUS) 

0  0  0 
CALL  BCODE  (5,  'ABCDE',  0.,  0.,  0.,  STATUS) 

0  0  o 
CALL  SAVFRM  (STATUS)         (See  Step  6) 
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Comments; 

•  The  call  to  DEFFRM  is  optional. 

•  This  step  can  only  be  preceded  by  Steps  1,  2,  and  6. 

•  DEFFRM  forces  the  BCP  software  to  enter  a  forms  definition 
mode  of  operation  in  which: 

Up  to  12  label  points  can  be  defined  by  calls  to  the 
DEFLBL  routine,  and 

Form   graphics   can   be   inserted   via   Step   4   routines 
below. 

•  Although  the  GETFRM  routine  can  be  used  while  defining  the 
form,  its  FIX  option  is  illegal  while  in  this  mode. 

•  The  FORM  definition  process  must  be  terminated  by  a  call  to 
SAVFRM  (..  tep  () )  . 

4.   To  enter  graphic  figures   --   Call  one  or  mere  of  the  follow- 
ing routines. 

BLOCK  Draw  BLOCK  character/s. 

BCODE  Draw  CODE  39  barcode. 

TEXT  Draw  text. 

VLINE  Draw  a  vertical  line. 

HLINE  Dr-jw  a  horizontal  line. 

VDASH  Draw  a  vertical  dash  line. 

HDASH  Draw  a  horizontal  dash  line. 

GETFRM  Insert  a  predefined  form. 

PUTFRM  Insert  a  fixed  form. 

Comments  ; 

When    calling    GETFRM: 

•  A    FORM     insertion    mode    of    operation     is    entered     where     label 
points    can    be    accessed    (see    P    Suffix    graphic    subroutines). 

•  GETFRM      or      PUTFRM      and      hence      FORM       insertion      mode       is 
terminated    by: 

—  A   call    to    the    ENDFRM    routine;    and/or 

—  A    call     to     PRINT,     PAGE,    or     REPEAT. 

•  During     FORM    definition,     GETFRM    cannot     be     called     with 
theFIXoption. 
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Tcj    proceed    from    here: 

Proceed    with    any    of    the    steps    that    follow.       However,     if    GETFHM^ 
was    entered,    proceed    with    Step    5. 

5.       To    terminate    FORM    insertion      —      Call    ENDFRM. 

Example : 

CALL    ENDFRM 

Comments ; 

•  The  FORM  insertion  mode  of  operation  initiated  by  a  call  to 
the  GETFRM  routine  is  terminated  by  one  of  the  fc.llowin^j 
CALL    statements. 

Another    GETFRM    or     PiJTFRM 

ENDFRM 

PRINT 

PAGE 

REPEAT 

•  Following  termination  of  the  FORM  insertion  mode  (normally 
by  ENDFRM),  the  form's  label  points  are  nc  longer 
accessible.  Therefore,  the  graphic  figure  routines  called 
by  using  the  P  suffix  (for  example,  BLOCKP,  CODEP,  and, 
TEXTP)     cannot    be    used. 

To    proceed    from    here : 

If    you    are    in    the    forms    definition    mode    (DEFFRM) ,    proceed    with 
either    Step    4    or    6. 

If     yoii     are     not      in     the      forms     definition     mode,      proceed     with 
either3tep4,7,3,or9. 

6.       To    terminate    form    definition    mode    and    save    the    form       —      Call' 
the    SAVFRM    routine. 

Example ; 

CALL    SAVFRM     (STATUS) 

Comments : 

SAVFRM    must    be    called    to     terminate    FORM    definition. 

To    proceed    from    here : 

Proceed    to    either    Step    2,     3,    4,    or    9 
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7.  To  repeat  the  current  contents  of  the  REQUEST  BUFFER   —   Call 
the  REPEAT  subroutine. 

Example; 

CALL  REPEAT  (2, 3, STATUS) 

Comments ; 

REPEAT  makes  the  following  assumptions. 

•  The  intervals  between  the  graphics  being  repeated  is 
determined  by  the  values  assigned  to  HTAB  and  VTAB  (detault 
values  are  1.0  inch  for  each,  the  values  may  be  changed  by 
calling  SETTAB)  . 

•  REPEAT  acts  upon  the  entire  contents  of  the  REQUEST  BUFFER, 
not  just  the  last  graphic  figure  entered. 

•  Following  REPEAT  by  a  call  to  PRINT  is  unnecessary. 
To  proceed  from  here; 

From  here,  you  may  go  back  as  far  as  Step  4. 

8.  To  terminate  the  current  plot  page   —   Call  the  PAGE  routine. 
Example; 

CALL  PAGE  (STATUS) 

Comments : 

PAGE  causes  the  current  contents  of  the  REQUEST  BUFFERS  to 

process  and  output.    Following  this,  LXY  " TOP -OF-FORM" 

character   is  output   to   the   printer.  The   plot   is   then 
reinitialized  to  the  top  of  the  next  page. 

To  proceed  from  here; 

From  here,  you  may  go  back  as  far  as  Step  4. 

9.  To  terminate  the  current  plot   —   Call   either   of  thes  •  two 
routines:  either  EXIT  or  FINISH 

Example : 

CALL  FINISH      Terminate  plot  and  wait  for  c.    NEWPLT  command. 

Comments : 

None 
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2.4   COMPILIN-:  AND  LINKING  AN  APPLICATION  PROGRAM 

After  an  application  program  is  coded,  it  should  be  compiled.   A 

typical  compilation  command  string  is  shown  below. 

•  For  RSX-UM: 
Example  : 

>F77    PROGRAM=PROGRAM.FTN 

•  For    VAX/VMS: 
Example: 

$FOR  PROGRAM 

Once  the  program  compiles  free  of  errors,  the  following  steps 
should  be  taken. 

•  For    RSX-llM: 

Task    build     (link)    the    program    shown    below. 

Example  : 

* 

>TKB 

TKB>PROGRAM/FP=PROGRAM,LB: [1, 1 ] BC PL IB/LB , F4P0TS/LB 

TKB>MAXBUF=140 

TKB>UNITS=8 

TKB>ASG=SY:7:8 

TKB>// 

If  you  wish  to  use  an  overlay  descriptor  (ODL)  file,  see 
the  file,  DEMOBLD.CMD,  for  example  of  how  this  file  can  be 
built.  Also,  refer  to  the  RSX--11M  BCP  Overlay  Guide 
(Figure  2-1,  page  2-3)  for  overlaying  poss io i i i t i es .  Task 
build    (link)     as    follows. 

Example : 

>TKB 

TKB>PROGRAM/FP=PROGRAM/MP 

TKB>MAXBUF=140 

TKB>UNITS=8 

TKB>ASG=SY:  7:8 

TKB>// 

•       For    VAX /VMS: 

Link    the    program    as    shown    below. 

Example: 

SLINK  PROGRAM, BCPLIB/LIB/INC=BCDATA 

The  program  can  be  run  at  this  time. 
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CHAPTER  3 
RSX-llM  INSTALLATION  NOTES 


Due  to  the  variety  of  system  configurations  available  to  the  user, 
this  chapter  only  provides  an  outline  for  the  system  requirements 
and  installation. 

3.1  SYSTEM  REQUIREMENTS 

The  general  system  requirements  are  as  follows. 

•  A  PDP-11   system   running   a  mapped   RSX-IlM   (V4.0)   and 
equipped  with  a  floating-point  processor 

•  A  minimum  28K  partition  to  run  the  CREATE  program 

•  200  blocks  of  on-line  disk  storage  for  the  GRAPHICS  FILE 

•  FORTRAN  77  Compiler  and  Object  Vime  System  (OTS) 

•  An  LXY  Printer/Plotter 

NOTE 
During  system  generation  of  your  RSX-llM  V4.0 
system,  the  LPll-Z  or  LPll-W  controller,  under 
peripheral  options  for  the  line  printer,  are 
recommended;  for  example,  LPR  Controller 
0[D:200,  177514,  LA  180,  0,  300,  16130] 
[S] : , ,LP-11-Z. 

3.2  SYSTEM  INSTALLATION 

The  outline  of  installation  is  as  follows. 

•  MOUNT  MEDIA  —  Depending  'ipon  system  configuration,  this 
could  involve  a  variety  of  media  types. 

Media  Types 

9-Track  800  BPI  Magtape 
RL02  Disk  Cartridge 
9-Track  1600  BPI  Magtape 
RL01  Disk  Cartridge 
RK06  Disk  Cartridge 
RX01  Floppy  Diskette 

The   media   label   is   BCP.     An   example   of   an   RL01 
distr  ibut ion  kit  is : 

>MOUNT  DL0:  BCP 
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•  RESERVE  DISK  WORK  AREA  --  This  work  area  is  for  the 
transfer  of  BCP  files  and  for  building  the  software 
package.  Now  set  the  default  UIC  to  this  area,  f  o  .• 
example : 

>SET    /UIC=[200,200] 

•  PRINTER/PLOTTER  —  If  the  PRINTER/PLOTTER  is  not  set  up 
for  lower  case  characters  and  134  characters/line,  it  can 
be    changed    by    the    MCR    SET    command,     for    example: 

>SET    /LOWER=LP0: 
>SET   /BUF=134. 

•  COP/  BCP  DISTRIBUTION  FILES  —  This  is  from  the  distribu- 
tion  media    to    the    work    area,    for    example: 

Using    RL01    distribution 

>SET    /UIC=[200,200] 

>PIP   dev :=DL0: [200, 200] *.* 

Using   magtape   distribution 

>FLX    dev:/RS=MM0: [ 200 , 200 ] * . */D0 

From  here  two  courses  of  action  are  possible.   They  are  either  to: 

•  Install  the  CREATE  program,  or 

•  Install  only  the  BCPLIB  library. 

To  install  the  CREATE  program,  you  need  to  invoke  a  special 
command  procedure  file  called  CREATE.  This  file  not  only  builds 
the  CREATE  program,  but  optionally  builds  the  BCPLIB  library. 

Type:   >@CREATE 

Then  respond  to  the  command  file's  dialog  as  in  the  following 
example . 

NOTE 
The  ins»-aller's  responses  are  underlined.   The 
installation  takes  approximately  20  Unutes. 
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>@CREATE 

>*    HAVE    YOU    COMPILED    THE    CREATE    PROGRAM?     [Y/N]:     N 

>*    ENTER    THE    NAME    OF    THE    FORTRAN-77    TASK:      [S]:     F77 

>F77    CREATE=CREATE.FTN 

>MAC    TPARS7=TPARS7 

>LBR    CREATE/CR:20  0:64:64:OBJ=CREATE,TPARS7 

>*    HAVE    YOU    BUILT    THE    BCP    LIBRARY?     [Y/NJ:     N 

>F77    BCP=BCP.FTN 

>F77    BCREQ=BCREQ.FTN 

>F77    BCDATA=BCDATA.FTN 

>F77    BCPRINT=BCPRINT.FTN 

>MAC    BARASM=BARASM.MAC 

>LBR    BCPLIB/CR:  300:  100.  :  100.  :  OB  J -BCHATA  ,  BCP  ,  BCUEtJ,  BCPR  [  NT  ,  BARAT.M 

>*    HAVE    YOU    BUILT    THE    CREATE    OVERLAY    DISCRIPTOR    FILE     (ODL)?     [Y/N]-' 

>*    ENTER    THE    NAME    OF    THE    FORTRAN-77    OTS    LIBRARY:      [S]:     F4P0TS 

>TKB    §CRLINK  

>§    <E0F> 

NOTE 
You  may  wish  to  install  the  CREATE. TSK  imaqo 
you  just  built  on  the  system  disk  UIC  [1,54] 
area  for  general  use.  Similiarly,  BCPLIB.OLB 
could  be  transferred  to  LB : [ 1 , 1 ]  for  general 
use. 

To  install  only  the  BCPLIB  library,  use  thp  BCPLIB  command  file. 
This  command  file  builds  the  BCPLIB  library  from  the  BCP  sour-e 
files.   To  use  BCPLIB.CMD,  type: 

>@BCPLI3 

and  respond  to  the  command  files  dialog  as  in  the  followinj 
example.  The      installer's      resoonses      aro      underlin»^d.  The 

installation    takes    approximately    8    minutes. 

>0BCPLIB 

>*  HAVE  YOU  BUILT  THE  BCP  LIBRARY?  [Y/N]:  N 

>*  ENTER  THE  NAME  OF  THE  FORTRAN-77  TASK:  [S]:  F77 

>F77  BCP=BCP.FTN  

>F77  BCREQ=BCREQ.FTN 
>F77  BCDATA=BCDATA. FTN 
>F77  BCPRINT=BCPRINT.FTN 
>MAC  BARASM^BARASM.MAC 

>LBR  BCPLIB/CR: 300: 100.  :  100.  : OB J =BCDATA , BCP, BCREO, BCPR I  NT , bARASM 
>P  <EOF> 

NOTE 
You  may  wish  to  move  the  BCPLIB.OLB  file  just 
generated  to  your  system  disk  (logical  device 
LB:)  UIC  [1,1]  for  general  use. 
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CHAPTER  4 
VAX/VMS  INSTALLATION  NOTES 


4.1   SYSTEM  REQUIREMENTS 

•  VAX/VMS  (V3.2)  Lr  later 

•  200  blocks  of  on-line  disk  stora<je  for  the  GRAPHICS  FILE. 

•  VAX-11  FORTRAN 

•  An  LXY  PRINTER/PLOTTER 

4.2   SYSTEM  INSTALLATION 

The    VAX-11    BCP    distribution    consists    of: 

•  BCP    User's   Guide,    and 

•  lurv    Iw.o^^'-'PP^^      ^'^^^      containin-j      distribution      Mies 
(VAX-ll/7fl0,     VAX-11/782), 

or 

•  Two     (2)    TU58    DECTAPE    II    cartridges    containing    distribution 
files     (VAX-Il/75a,     VAX-11/730).  wiDucion 

The    installation     instructions    for    VAX-LI    BCP    are    listed    below. 

1.      The      following      privileges     are      needed      for      the      installation. 

CMKRNL 
OPER 
SYS NAM 
SYSPRV 
LOG_I 0 

Example:       SET    PROC/PR IV- (CMKRNL. OPER, SY5NAM , SYS PRV, LOG_I 0) 

2.  Set    the    UIC    to     [1,4  )  . 

Example:       SET    UIC     [1,4] 

3.  Set    the    default    as    follows.       SET    DEF    SYS $S YSHOOT : [SYSUPD] 

4.  Mount    the    destination    device    if     it    is    m.t    presently    mounted. 

5.  Create    the    destination    directory    if    it    does    not    exist. 
E/ample:       Create/dir    DBC0:fBCP] 
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Note 
The    user    must    know    the    device    name    and    number 
of    the    LXY    PRINTER/PLOTTER. 

6.  Type  @VMSUPDATE  and  respond  to  the  dialog.  VMSUPDATE  calls 
the    BCP    installation    command    file. 

•  The    BCP    installation    command    file: 

Copies  all  files  to  the  destination  device  and 
d  irecto  ry , 

—      Compiles     and      links     the      library      (BCPLIB)       and      CREATE 
prog  rams , 

Optionally    compiles    and    links    the    BCP    DEMO    program,    and 

Optionally  sets  the  LXY  printer  characteristics  to 
those  required  by  the  BCP  software  -  lowercase, 
printall,    nowrap,    and    width=134. 

•  A   sample    installation    dialog    is    attached 

7.  The  user  is  informed  of  the  success  or  failure  of  the  BCP 
installation.  If  the  installation  fails,  recheck  Steps  1 
through  5.  If  the  steps  match  the  user  installation,  check 
for    device    problems. 

8.  Upon  successful  completion  of  the  BCP  installation,  refer  to 
Appendix    D    for    BCP    verification    procedures. 

The    following    command    files    provide    the    ability    to    rebuild    any    or 
all    parts   of    VAX-11    BCP.       They    are: 

•  BCPLIB.COM      —   Used      to      recompile     and      relink     the     BCPLIB 

rout  ines , 

•  CREATE.CoM   —  Used   to   recompile  and   relink  the  CREATE 

program,  and 

•  DEM0.COM  —   Used      to      recompile     and      relink      the     DEMO 

program. 

Sample    Dialog : 

$SET    PROC/PRIV^ (CMKRNL,OPER,SYSNAM,SYSPRV, LOG_IO) 

$SET    UIC     [1,4] 

$SET    DEF    SYSSSYSROOT: [SYSUPD] 

$@VMSUPDATE 
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VMS  Update  Procedure 
This  command  procedure  performs  VAX/VMS  software  updates  and 
optional  software  installations  for  VAX/VMS  Release  i.  Durirnj 
this  sequence,  the  standard  conscae  medium  is  not  present  in  the 
console  drive.  Therefore,  the  system  may  be  vulnerable  to  a  power 
failure  or  other  fatal  crash.  If  a  system  crash  occurs  during) 
this  period,  the  update  sequence  can  be  restarted  at  the  bejinnifiq 
of    the    first    incomplete    update. 

Dismount    the    current    console    medium. 

Please    place    the    first    volume    in    the    console    drive 

Are    you    ready    to    continue?:     Y 
%MOUNT-I-MOUNTED,     BCPl  mounted    on   _CSA1 

Starting    installation   of    VAX-U    BCP 

6-APR-1983     14:10:58 

Your    UIC    must    be    set    to     [1,4]     and    you    must    have    the    following 
privileges    to    install    BCP: 

OPER  CMKRNL  LOG    10 

SYSPRV  SYSNAM 

Do    you    have    these    privileges    and    want    to    continue     [Y/N]:     Y 

To      print     barcode     output     on     an      LXY      PRINTER      the      following 
printer    characteristics    must    be    set: 

lowercase  printall 

nowrap  width=134 

Do    you    wish    to    set    the    characteristics    now:    Y 

Enter    the    LXY    PRINTER    device    name    and    number    "ddnn:"     :     LPAH: 

Enter    BCP   destination    area    "dev ice :[ d i rector y] "     :     DBC0:[BCP] 

Remove    the    first    volume     (BCPl)     and    place    the    second    volume     (BCP2) 
in    the   d  r  ive  . 

6-APR-1983       14:16:57 
Is    the    second    volume    (BCP2)     in    the    drive     fY/N]:    Y 

6-AP'(-1983     14:16:57 
%MOUNT-I-MOUNTED,     BCP2  mounted    on   _CSA1: 

Copying    the    CREATE    HELP    file    into    the    system    help    area 
***   The    programs    are    now   being    compiled    and    linked    *** 
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Do    you    wish    to    compile    and    link    the    demo    program    [Y/N):    Y 
BCP    installation    has    completed    successfully    — 

*  all    files    have    been    copied 

*  all    required    programs    are    compiled    and    linked 

6-APR-i983     14:25:36 
Are    there   more    kits    to    process?:    N 
Please    place    the      system    console    medium    in    the    console    dri 

Are    you    ready    to    continue?:    Y 

%MOUNT-I-MOUNTED,    CONSOLE  mounted    on      CSAl: 

Requested    update    sequence    is    complete.  ~ 


vo 


c^ 
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APPENDIX  A 
BCPLIB  SUBROUTINES 


Appendix  A  is  an  alphabetical  listing  of  the  command  subroutines. 

A.l   BCODE 

Draw  a  BARCODE  of  the  characters  in  the  array  string. 

Format : 


BCODE  (N,  LIST,  DX ,  DY ,  SIZE,  STATUS) 
BCODEA  (N,  LIST,  X,  Y,  SIZE,  STATUS) 
BCODEP  (N,  LIST,  P,  SIZE,  STATUS) 


Arguments: 

N  An  integer*2  variable  or  array  element  that  is  the 

number  of  characters  in  LIST  below. 

LIST  A  character  variable  or  constant  containing  the 
characters  being  plotted  in  barcode  format. 

DX,DY  Real  variables  or  array  elements  that  specify  an 
offset  distance  in  inches  (resolution  of  0.1  inch)  to 
move  the  GRAPHIC  POINTER  for  insertion  of  the  barcode 
figure . 

X,Y  Reai  variables  or  array  elements  that  specify  a  new 
position  for  the  GRAPHIC  POINTER  for  insertion  of  the 
barcode  figure.  The  units  are  inches  and  resolution 
is  0. 1  inch  . 

P  An  integer*2  variable  or  array  element  that  specifies 

a  form  LABEL  POINT.  The  GRAPHIC  POINTER  is  to  be  set 
to  the  value  of  the  named  LABEL  POINT  for  insertion  of 
the  barcode  figure.   P  is  a  number  between  1  and  12. 

SIZE  A  real  variable  or  array  element  that  specifies 
barcode  size  (height)  in  'nches.  The  resolution  i  r. 
0.1  inch. 
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STATUS  An  integer*2  variable  ir  array  element  where  the  BCODK 
subroutine  stores  a  status  code  describin.j  the  action 
taken  on  the  CALL  (or  request)  .  On  normal  or 
successful  return  from  the  subroutine,  STATUS  has  a 
value  of  1.  Otherwise,  either  an  error  or  warning 
condition  results.  Refer  to  Appendix  C  for  a 
description  of  this  problem. 

Description: 

The  BCODE  subroutine  makes  a  request  to  draw  (or  plot)  a  list  of 
characters  in  CODE  39  BARCODE  format.  The  barcocJe  heiijht  in 
determined  by  the  argument  SIZE  (unless  its  value  is  fl  in  which 
case  an  internal  parameter,  by  the  same  name,  is  uTed) .  Initial- 
ly, the  internal  (or  default)  value  for  SIZE  is  1.0  inch,  but  this 
quanti  '  can  be  chanqed  by  a  call  to  the  SETFIG  subroutine. 

The  barcode  is  drawn  with  a  ratio  (wide  line  widths  to  thiin  line 
widths  and  similar  spaces)  of  either  2:1  or  3:1,  that  is  dependent 
upon  the  value  of  an  internal  parameter  RATIO.  RATIO  has  an 
initial  value  of  2,  however,  the  SETFIG  command  can  be  used  to 
change  this  value  to  3. 

Barcode  text  optionally  can  be  printed  along  with  the  barcode 
figure.  The  barcode  height  is  shortened  by  0.2  inch  for  text 
insertion  with  this  option.  Initially,  the  text  option  is  set  to 
include  the  printed  text,  however,  the  SETFIG  command  may  be  used 
to  specify  that  no  text  be  included  (see  the  OMIT  parameter)  when 
plotting  barcodes. 

The  barcode  is  inserted  at  the  current  GRAPHIC  POINTER  position 
starting  at  the  lower  left  corner  of  the  barcode  figure  itself. 

Upon  completion  of  the  BCODE  command,  the  GRAPHIC  POINTER  is  left 
at  the  lower  right  corner  of  the  figure. 

Examples: 

1.  CALL  BCODE  (4,  'ABCD',  6.0,  1.0,  5.0,  STATUS).  Generate 
a  CODE  39  barcode  for  the  characters  "ABCD".  The  barcode  is 
drawn  at  a  height  of  5.0  inches  and  inserted  in  the  PLOT  PAGE 
at  a  position  6.0  inches  down  the  page  (X  direction)  and  1.0 
inch  across  the  page  (Y  direction)  from  the  current  GRAPHIC 
POINTER  position. 

2.  CALL  BCODEP  (5,  'A123Z*,  5,  3,  STATUS).  Generates  a  CODE  39 
barcode  for  the  characters  "A123Z"  at  the  position  defined  by 
the  current  form's  5th  LABEL  POINT. 
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A.  2  BLOCK 

Draw  block  characters  listed  in  the  array  list 

Format : 


BLOCK     (N,     LIST,     DBUT,     DX ,     DY ,     SIZF. ,     STATUS) 
BLOCKA     (N,     LIST,     DBHT,     X,     Y,     SIZK,     STATUS) 
BLOCKP     (M,     LIST,     DBHT,     P,     SIZE,     STATUS) 


Arguments ; 
N 

LIST 


DBHT 


DX,DY 


X,Y 


An     inte'3er*2     variable    or     array    element 
number    of    characters    in    LIST    below. 


that  is  the 


A   character   variable  or 
characters  to  be  plotted. 


constant   containing   the 


Legal  characters  are 


A-Z 


Lo'jical  constant  on  variable.  IF  DaHT  has  the  valae 
of  .TRUE.,  then  draw  the  characters  double  height. 
If  DBHT  has  any  other  value,  refer  to  the  system 
parameter  by  the  same  name  to  determine  how  to  draw 
the  characters.  The  initial  value  for  the  default 
system  parameter  DBHT  is  .FALSE.  See  SETFIG  command 
to  change  the  default  value. 


Real  variables  or   array  elempnts   tha 
distance  in  inches  {resolution 
the   GRAPH!':   POINTER   for 
characters . 


spec  i  f  y 

of     0.1     i  nch)     to    move 

Insertion      of       the      block 


Real  variables  or  array  elements  tl^at  specify  a  new 
position  for  the  GRAPHIC  POINTER  for  insertion  of 
the      BLOCK     characters.  The      units      are      inches      and 

resolution    is    (?.l     inch. 


An     integer*2     variable    or 
fies    a    form    LABEL    POINT, 
to     the    value    of    the    named 
of     the     BLOCK    characters, 
and    1.2. 


arra/     element     that     spe'i- 

Tl       GRAPHIC    POINTER     is    set 

LABEL     POINT     for      inr>.«rtion 

P     is    a     number     between     1 


SIZE 


A  real  variable  or  array  element  that  specifies 
character  size  (height  and  width)  In  inciies.  The 
resolution  is  0.1  inch. 


STATUS  An      inteqer*2     variable     or      array     element      where      the 

BLOCK  subroutine  stores  a  status  co'ie  describini  th'- 
action  taken  on  the  CALL  (or  request).  On  n-rmil  or 
successful  return  from  the  subroutine,  STATUS  has  j 
value  of  1.  Otherwise,  either  an  error  or  warning 
condition       resul'cs.  Refer       to      Appendix      C      f.^r      a 

description    of    this    problem. 

Descr  ipt  ion : 

The  BLOCK  subroutine  makes  a  request  to  iraw  (..r  plot)  a  li;-,t  of 
characters  in  block  format.  BIock  formatted  character;  ire  Irawn 
so  that  the  character  neiqht  and  the  width  are  the  same  unless  tht- 
double-he  icjht  option  (/D)  is  specified.  For  double  heijht,  the 
character  height  is  twice  the  width.  The  character  width  includes 
inte rchar acter  spacing  on  the  character's  r i jht  iide,  that  is 
l/6th    of    the    total    width. 

Whenever  the  size  argument  is  0,  the  character  height  and  widtn  is 
determined  by  the  internal  parameter  by  the  sam**  n.ime  (  5I7.E)  . 
Initially,  SIZE  has  the  value  ot  1.0  inch,  however,  its  value  '.-an 
be    changed    by    using    the    SETFIG    subroutine . 

The  characters  are  inserted  at  the  current  GRAPHIC  POINTER 
position    starting    at    the    lower    left    corner    of    the    first    character. 

Upon  completion  of  the  BLOCK  subroutine,  the  GRAPHIC  POINTER  is 
left  at  the  last  character's  lower  right  corner  (includin)  the 
inter cha r acter    space). 

Examples: 

1.  CALL  BLOCK  (1,  ' ABC ',. TRUE .,  1 . 0 , 1 . 0 , 0 ., STATUS )  .  Draw  the 
three  characters  "ABC"  in  doubl e-he i jht  block  format.  Move 
the  GRAPHIC  POINTER  a  distance  of  1.0  inch  horizontally  an  1 
1.0  inch  vertically  beforo  Inserting  the  characters  intc.  t  h«.' 
PLOT  PAGE.  Since  SIZE  is  0,  draw  the  characters  havin}  a  size 
as  defined  by  the  system  default  SIZE  parameter  (see  SETFIG 
subrout  i  ne)  . 

2.  CALL  BLOCK  (7,  '123  ABC,  0  .  0  ,  0  .  0  ,  3 .  0  ,  STATUS  )  .  Draw  the  seven 
characters  "123  ABC"  in  standard  (no  double-height)  block 
format.  Inse.t  the  characters  at  the  current  GRAPHIC  POINTER 
position.  Draw  the  characters  of  height  and  wiiith  o(  3.0 
inches. 

3.  CALL  3L0CKP  (J,  '  ABC  '  ,  .  f  a  1  se  .  ,  5  ,  1 .  5  STATUS).  Draw  t  h.'  three 
characters  "ABC"  in  a  standard  block  format  with  a  SIZE  of  l.S 
Inches.   Insert  the  characters  at  the  current  form':;  'i'  h    LABEL 


POINT. 


• 
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A. 3  DEFFRM 

Define  a  form.   Following  the  "DEI<'FRM"  call,  the  user  is  expected 
to  fjovide  the  form's  graphics  via  standard  subroutine  calls  in 


the   identical  manner   as  normal  graphic   input, 
graphics  are  specified,  the  "SAVFRM"  call  is  made 
form  definition  and  save  the  form  for   future 
graphic  figures  are  checked  to  fall  within  the 
(XLIM,YLIM)  . 


When   all   the 

to  terminate  the 

use.    All   form 

form  boundaries 


Format: 


DEFFRM  (FILESP,  UNIT,  XLIM,  YLIM,  STATUS) 


Arguments; 

FILESP 


Character  constant  or  variable  --  File  nam3  of 
the  FORM  FILE  being  created  to  store  the  new  form. 
This  is  a  FILE  SPECIFICATION  as  defined  in  the 
RSX-11  M/M-Plus  MCR  Operations  Manual,  Section  2.2, 
for  RSX-Il  BCP  or  VAX/VMS  Command  Language  User's 
Guide,  Chapter  2,  for  VAX-Il  BCP. 


UNIT 


XLIM 


Inteqer*2   --   If  UNIT  is  not  0,  then  it 
the  form  file's  Logical  Unit  Number  (LUN). 
is  0,  then  the  default  LUN  b  is  used. 


Real  variable 
inches.   R'^OLUTION 


Maximum  length  of  the 
is  0.1  inch . 


becomes 
If  UNIT 


form  in 


YLIM 


Real  variable 
RESOLUTION  is 


0.  1 


Max  imum 
inch  . 


width  of  form  in  inches 


STATUS 


STATUS  is  an  integer*2  variable  or  array  element 
where  the  DEFFRM  subroutine  stores  a  status  code 
describing  the  action  taken  on  the  CALL  (or 
request) .  On  normal  or  successful  return  £rom  the 
subroutine,  STATUS  has  a  value  of  1.  Otherwise, 
either  an  error  or  warning  codition  results.  Refer 
to  Appendix  C  for  a  description  of  this  problem. 


Description: 

The  DEFFRM  subroutine  initiates  a  FORMS  definition  mode  of 
operation  where  the  user  can  call  graphic  figure  routines  to 
describe  the  form  in  terms  of  lines,  barcodes,  text,  and  block 
characters.  These  calls  are  then  saved  for  later  use  on  a  disk 
file.  The  FORM  can  also  include  LABEL  POINTS  defined  by  the 
DEFPNT  subroutine.  When  the  FORM  is  completed,  the  user  calls  the 
SAVFRM  routine  to  save  the  FORM  and  its  contents  on  a  special  disk 
file  crested  for  this  purpose.  FORMS  may  not  be  defined  after 
normal  plotting  starts. 
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Examples: 

1.  CALL  DEFFRM  ( ' NEWFRM . FRM ' ,  0,5.0,6.0,  STATUS)  defines  j  form 
called  NEWFRM.FRM  and  initiates  a  FORM  definition  mode  of 
operation  where  the  form's  GRAPHICS  are  entered,  A  file 
called  NEWFRM.FRM  is  created  and  the  FORM  header  inserted. 
Such  routines  as  BCODE ,  BLOCK,  etc.,  can  now  be  called  to 
describe  the  FORM'S  contents.  A  later  call  to  SAVFRM 
terminates  FORM  building  and  stores  the  graphics  on  the  disk 
file.  The  file  is  then  closed  and  the  form  insertion  mode  is 
terminated . 

2.  CALL  DEFFRM  ( ' BCP. FRM '  , 0 , 5  .  0 , 5  .  0  ,  STATUS)  defines  a  form  to 
store  on  the  file  BCP. FRM.  Associate  logical  unit  8  to  the 
form  file.  The  form's  vertical  limit  is  5.0  inches  and  width 
is    5.0    inches. 


• 
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A.  4       DEFLBL 

DEFINE    a    label    point    at    the    FORM    offset    position    X,Y. 

Format: 


I  I 

I  DEFLBL  (N,X,Y,  STATUS)  I 

I  ! 


Arguments: 


An  integer*2  constant  variable  identifying  the 
LABEL  POINT  number . 


X,Y  Real  variables  that  specify  position  on  the  FORM 

relative  to  the  where  the  LABEL  POINT  is  located. 
X  and  Y  are  expressed  in  whole  or  tenth  inch  units. 

STATUS  An   inteqer*2  variable  or  array  element  where  the 

DEFLBL  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 

Descr ipt  ion : 

DEFLBL  defines  a  form  LABEL  POINT  (Section  1.3).  This  subroutine 
may  only  be  called  while  BCPLIB  is  in  the  FORMS  definition  mode  of 
operation.  The  forms  definition  mode  is  initiated  by  a  call  tc 
the  DEFFRM  subroutine  and  terminated  by  calling  SAVFRM.  DEFLBL 
associates  a  position  X,Y  relative  to  the  form  base  and  associates 
it  to  a  LABEL  POINT  number.  Later,  this  same  relative  position 
may  be  accessed  via  reference  to  the  associated  number. 
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A. 5   ENDFRM 

Terminate  form  definition.   Close  the  form  file 

Format : 


ENDFRM 


Arguments: 

None 

Description: 

ENDFRM  terminates  the  form  insertion  mode  of  operation  initiated 
by  calling  GETFRM  or  PUTFRM  subroutines. 
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A.  6   ERASE 

Erase  current  contents  o"    the  request  buffers. 

Format : 


I  ERASE  (ID,  STATUS) 


Arguments : 

ID  Character  string  or  variable  that  identifies  what 

to  er^se.  ID  can  have  a  value  of  one  of  the  three 
fol.    .ig  character  strings. 

r   REQ  —  Erase  REQUEST  BUFFER  only. 

•  FIX  —  Erase  FIXED  FORM  only. 

•  ALL  --  Erase  both  buffers. 

STATUS  An   integer*2  variable  or  array  element  where  the 

ERASE  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 

Description: 

Enables  the  caller  to  erase  the  current  contents  of  the  REQUEST 
BUFFERS  and/or  FIXED  FORM  BUFFER.  A  call  to  ERASE  with  the  ID 
argument  having  a  value  of  FIX  is  the  only  way  to  remove  a  FIXED 
FORM  from  memory,  short  of  terminating  the  PLOT. 
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A. 7   EXAM 
Format : 

I 


EX^M  (TYPE,  BUFFER,  STATUS) 


Arguments : 

TYPE 


BUFFER 


Character  constant  or  variable  identifyinj  t'lo  type  ot 
parameters  to  examine.   They  are: 

POS  --  POSITION  parameters; 

PAG  —  PAGE  parameters; 

FIG  —  FIGURES  parameters; 

FOR  --  FORM  parameters;  r\n<i 

ALL  —  POS,  PAG,  FIG,  and  F')R  ptrametors. 

Real  array  to  contain  the  requested  parameters.    Th-; 
contents  depend  upon  parameter  type(s)  request'.'d. 

•   POS  —  5  words  to  hold  posit  iin  data  are  the: 

--  XR  -  X  coordinate  of  REFEREN'.'E  ORIGIN, 

—  XR  -  Y  coordinate  of  REFERENCE  ORIGIN, 

—  XC  -  X  coordinate  of  GRAPHIC  POINTER, 

—  YC  -  Y  coordinate  of  GRAPHIC  POINTER,  and 

—  SECTIJN  -  Start  of  current  SECTION. 


•   PAG  --  4  woris  to  contain  pa^e  parameters, 
paje  parameters  are: 


The 


—  XLIM    -    Paje    limit     in  X    direction     (LENGTH), 
YLIM    -    Pa'^je    limit    in  Y   direction    (WIDTH)  , 
VTAB    -    Current    value  of    the    vortical    TAB,     an  i 
HTA&    -    Current    value  of    the    horizontal    TAB. 

FIG    —    3    words    that    contain    figure    data    arei 

SIZE    -    Character    size, 

—  DBHT    -    Double-height    FLAG     (1     ^-    single    height; 
=    do  uble    he  ight ) , 

RATIO      -   BarcofJe    rat  if),    «nd 
BCTEXT    -    Barcode    text    FLAG     (^    » 
the      barcode      figure;      "      -        -' 
barcode    figure) . 


N 


om  it 


I nc 1 ude  text  in 
text   in   the 


A-IH 


STATUS 


•  FOR  —  26  worJa  to  contain  (GETFRM)  torm  data.   The 
form  parameters  are: 

--   XLIM   -  Form  lenyth, 

YLIM   -  Form  width,  anl 
—   POINT  -  24  words  of  X,Y  data  definin-j  label 

points  in  order  ~  2  words  per  label  point. 

•  ALL  —  38  words  to  -contain  all  - .  f  the  above 
information  in  order  shown. 

An  inte'^jer*2  variable  or  array  element  where  the  EXAM 
subroutine  stores  a  status  code  duscr  ib  i  n<j  the  action 
taken  on  the  CALL  (or  request).  r)ri  nc;rmal  or 
successful  return  from  the  subroutine,  STATUS  has  a 
value  of  1.  Otherwise,  c?ither  an  error  or  warning 
condition  results.  Refer  to  Appendix  C  for  a 
description  of  this  prc;bl''Ti. 


Description: 

EXAM  returns  to  the  caller  the  current  values  of  selected  internal 
parameters.  All  parameters  are  converted  to  real  format  upon 
return,  therefore,  the  logical  variabl>^?s  should  be  interpreted  as 
.FALSE,  if  the  r  ■.-turned  value  is  d,    and  .TRUE,  otherwise. 
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A. 8   FINISH 

FINISH  terminates  graphics  and  closes  all  files. 

Format : 


FINISH  (STATUS) 


Arguments: 


STATUS 


Description: 


An  integer*2  variable  or  array  element  w^iere  the 
FINISH  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request)  .  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 


Terminate  the  current  plot  and  make  preparations  to  receive 
another  INIT  subroutine  call  to  start  a  new  plot.  If  the  request 
buffers  are  not  empty,  call  the  PROCES  and  PAGE  routines  as  needed 
to  complete  the  current  plot  and  advance  the  page  in  preparation 
for  a  new  plot  to  start. 


A-12 


A.  9   GETFRM 

Get  FORM.   Read  FORM  from  file  and  enter  contents  into  the  REQUEST 
BUFFERS. 

Format : 


GETFRM  (FMFILE,  FIX,  X,  Y,  STATUS) 


Arguments: 

FMFILE  A  character  constant  or  variable  for  the  FORM  file 
name.  FMFILE  is  a  file  specification  as  defined  in 
the  RSX-llM/M-Plus  MCR  Operations  Manual,  Section 
2 . 2  "o7  VAX/VMS  Command  Language  User's  Guide  , 
Chapter  2.  A  default  of  .DAT  is  used  when  the  file 
extension  is  omitted. 

FIX  Logical*2  flag.   Set  to  .TRUE,  to  fix  the  FORM  int; 

memory . 

X,Y  Real  variables   —   New  position  for  the  REFERENCE 

ORIGIN,  -and  thus  the  FORM  insertion  point. 

STATUS  An  :nteger*2  variable  or  array  element  where  the 
GETFRM  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request)  .  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Apandix  C  for  a  description  of  this  problem. 

Description: 

GETFRM  requests  a  form  from  a  disk  file  and  inserts  it  in  the 
REQUEST  buffer  in  the  same  manner  as  a  normal  graphic  request 
(such  as  BCODE)  stores  its  data.  In  addition,  GETFRM  initiates  a 
forms  insertion  mode  of  operation  that  permits  accessing  of  LABEL 
POINTS  by  tne  graphic  subroutines  via  the  P  suffix  entry  (see 
BCODEP,  BLOCKP,  TEXTP,  etc.,  command  descriptions). 
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The  forms 
rout  ines . 


insertion  mode  is  terminated  by  one  of  the  following 


Another 

ENDFRM 

PROCES 

PAGE 

REPEAT 


GETFRM  subroutine  call 


The  FIX  argument  may  be  used  to  cause  the  form  contents  being 
saved  or  fixed  in  a  special  place  in  the  memory  for  shared  use.  A 
fixed  form  may  be  reused  for  any  number  of  positions  on  the  page 
via  the  PUTFRM  command  from  a  single  copy  of  its  graphic  contents 
stored  in  this  way. 

Whenever  a  form  is  fixed  into  memory,  another  call  to  GETFKM  can- 
not be  made  until  the  form  is  removed.  A  fixed  form  is  removed 
only  by  the  ERASE  command  using  the  FIX  parameter. 

Examples: 

1.  CALL  GETFRM  ( ' B INLBL. FRM '  ,  0 ,  1 . 0 , 3 . 2 , STATUS )  reads  a  form  Crom 
the  file  BINLBL.FRM  and  stores  its  graphic  content  into  the 
REQUEST  BUFFERS  for  later  Phase  2  processing  into  plottable 
data.  The  FORM  contents  are  inserted  on  the  PLOT  page  at 
coordinate  position  (1.0,3.2). 

2.  CALL  GETFRM  (  ' PR  ICE. LBL '  , . TRUE . , 3 . 6 , 5. 2 , STATUS)  reads  a  form 
from  the  file  PRICE. LBL  and  stores  it  into  the  fixed  form 
buffer  to  FIX  the  form.  The  form  is  inserted  on  the  PLOT  paae 
at  coordinate  position  (3.6,5.2)  and  wherever  specified  by 
later  PUTFRM  subroutine  calls. 
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A.  10      GETLBL 

Set    current    position    pointer    to     label    point    N, 

Format : 


GETLBL     (N,     STATUS) 


Arguments: 

N  An  inte]er*2  variable,  constant,  or  array  oiement 

specif  yint]  the  LABEL  POINT  by  number.    N  i -,  any 
number  between  1  and  12. 

STATUS  An  inte^er*2  variable  or  array  element  where  the 
GETLBL  subroutine  stores  a  status  code  describin-^ 
the  a':tion  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  -either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  descripticm  of  this  problem. 

Description: 

GETLBL  moves  the  GRAPHIC  POINTER  to  a  new  position  that  is 
associted  with  the  current  form's  LABEL  POINT  N.  This  subroutine 
may  only  be  called  when  the  software  is  in  the  forms  insertion 
mode  of  operation.  The  forms  insertion  mode  is  initiated  by  the 
GETFRM  and  PUTFRM  subroutines  and  terminated  by  a  call  to  the 
ENDFRM  subroutine  or  any  routine  that  initiates  Phase  2  processing 
(PROCES,  PAGE,  REPEAT). 
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A.  11   HDASH 

Dashed  horizontal  line. 

Format ; 


HDASH  (LENGTH,  DX ,  DY ,  THICK,  STATUS) 
HDASHA  (LENGTH,  X,  Y,  THICK,  STATUS) 
HDASHP  (LENGTH,  P,  THICK,  STATUS) 


Arguments: 

LENGTH  A  real  variable  or  array  element  that  specifies  the 
LINE  LENGTH.  The  UNITS  are  in  inches  and  the 
resolution  is  0.1  inch. 

DX,Dy  Real  variables  or  array  elements  that  specify  an 

offset  distance  in  inches  (resolution  of  0.1  inch) 
moves  the  GRAPHIC  POINTER  for  insertion  of  the 
DASHED  LINE. 

X,Y  Real  variables  or  array  elements  that  specify  a  new 

position  for  the  GRAPHIC  POINTER  for  insertion  of 
the  DASHED  LINE.  The  units  are  inches  and 
resolution  is  0.1  inch. 

P  An   inte9er*2   variable   or   array   element   that 

specifies  a  form  LABEL  POINT.  The  GRAPHIC  POINTER 
is  set  to  the  va^ue  of  the  named  LABEL  POINT  tor 
insertion  of  the  DASHED  LINE.  P  is  a  number  from  1 
to  12. 

THICK  A  real  variable  or  array  element  that  specifies  the 

line  thickness.  If  THICK  has  a  value  of  0,  rt 
normal  line  of  a  thickness  of  0.039  inch  is  drawn. 
If  THICK  is  •3reat3r  than  0,  then  it  specifies  the 
thickness  of  the  line  in  whole  and/or  tenth  of  an 
i  nch  units. 

STATUS  An  integer*2  variable  or  array  element  where  the 
HDASH  subroutine  stores  a  status  code  describin<j 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  tc' 
Appendix  C  for  a  description  of  this  problem. 
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Descr  ipt ion: 

The  HDASH  routine  makes  a  request  to  draw  (cr  plot)  a  horizontcjl, 
Jashed  line.   Length  of  the  line  is  specified  by  the  user. 

The  lines  are  inserted  at  the  current  GRAPHIC  POINTER  position. 

Upon  completion  of  the  HDASH  routine,  the  GRAPHIC  POINTER  is  left 
at  the  end  of  the  line  or  the  Lower  rijht  corner  of  i    thicK  line. 


A-17 


A. 12   HLINE 
Format : 


I  I 

I  MLINE  (LENGTH,  DX ,  DY ,  THICK,  STATUS)  | 

I  HLINEA  (LENGTH,  X,  Y,  THICK,  STATUS)  I 

I  HLINEP  (LENGTH,  P,  THICK,  STATUS)  I 

Arguments : 

LENGTH  Line  length  in  inches  with  resolution  of  0.1  Inch 

(real  variable). 

UX,DY  Real  variables  or  array  elements  that  specify 

offset  distance  in  inches  (resolutun  of  0.1  incr, 

muves  the  GRAPHIC  POINTER  for  insert  i;..n  '.f  th-j 
LINE. 

X,Y            Real   variables  or   array  elements   specify  a  new 

position  for  the  GRAPHIC  POINTER  for  insertion  of 

the  LINE.  The  units  are  inches  and  resolution  i> 
0.  I  inch  . 

P  An  tnte'3er*2  variable  or  array  element  specifies 

form  LABEL  POINT.  The  GRAPHIC  POINTER  Is  set  tt. 
the  value  of  the  named  LABEL  POINT  for  insertion  of 
th  •  line.   P  is  a  number  between  1  and  12. 

THICK  A  real  variable  or  constant  that  specifies  the  lint- 

thickness.  If  THICK  has  a  value  of  0,  a  normal 
line  of  thickness  of  approximately  0.039  inch  is 
dr.::<wn.  If  THICK  is  jreater  than  0,  a  line  of  the 
specified  thickness  is  drawn.  The  thickness  is 
expressed  in  whole  and/or  tenth  of  an  inch  units. 

STATUS  An  inte'jer*2  variable  or  array  element  where  the 

HLINE  subroutine  stores  a  status  code  descrihin) 
the  action  taken  on  the  CALL  I(t  request)  .  Jn 
normal  or  successful  return  fron,  the  subrotititi", 
STATUS  has  a  value  of  1.  ottierwise,  either  ^n 
error  or  warninfj  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 
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Descr  iption : 

The  HLINE  command  makes  a  request  to  draw  (or  plot),  a  horizontal 
line.   Length  of  the  line  is  specified  by  the  user. 

The  lines  are  inserted  at  the  current  GRAPHIC  POINTER  position. 

Upon  completion  of  the  HLINE  command,  the  GRAPHIC  POINTER  is  left 
at  the  end  of  the  line  or  at  the  lower  right  corner  of  a  thick 
1  ine . 
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A. 13   INIT 

Initialize  BCP  Library  for  new  plot. 

Format: 


INIT     (FILENAME,     LUN,     STATUS) 
INI      (STATUS) 


Arguments : 

FILENAME  A  character  variable  or  constant  tilename  for  the 
fgraphics  file.  FILENAME  is  a  file  specification  as 
defined  by  the  RSX- 1 1 M/M-P 1  us  MCR  Operations 
Manual  ,  Section  2.2  or  the  VAX/VMS  Command  Lantjuage 
User ' s  Gu  ide ,  Chapter  2.  Whenever  the  filename  is 
spec  i  f  iced  omitting  the  extension,  the  default  of 
.FRM  is  assumed.  FILENAME  can  be  specified  as 
blank  characters,  where  the  default  name  HCP.PLT  is 
assumed  . 

LUN  An  integer*2  variable  or  constant  that  specifies  a 

logical  unit  number  for  the  '^aphics  file.  If  LUN 
is  0,  a  default  Vc^lue  of  2  is  assumed. 

STATUS         An  integer*2  variable  or  array  element  where  the 

INIT  "Subroutine  stores  a  status  code  describing  t*-e 
action  taken  on  the  CALL  (or  request).  On  normal 
or  successful  return  from  the  subroutine,  STATUS 
has  a  value  of  1.  Otherwise,  either  an  error  or 
warning  condition  results.  Refer  to  Appentix  C  for 
a  description  of  this  problem. 

Description ; 

The  INIT  routine  has  two  entry  points,  INIT  and  INI.  The  INIT 
entry  reinitializes  the  BCPLIB  routines  for  a  new  plot  output. 
The  user  is  required  to  call  this  subroutine  for  each  plot.  Forms 
can  be  defined  and/or  plot  output  generated. 

The  INI  entry  is  an  alternate  entry  point  for  users  wishing  to 
define  forms  but  not  to  generate  plot  output.  INI  serves  these 
users  by  not  opening  a  graphics  file  that  is  ni?ver  used.  Phase  2 
processing  (PROCclS,  PAGE,  REPEAT)  cannot  be  initiated  followinq 
the  INI  call. 
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A.  14   MOVPTR 

Move  current  GRAPHIC  POINTER  position  X,Y. 

Format : 


MOVPTR  (X,  Y,  STATUS) 


Arguments! 
X,Y 

STATUS 


Real   variables  or   array  elei.ients   specify   a  new 

position  for  the  GRAPHIC  POINTER  relative  to  the 

REFERENCE  ORIGIN.  The  units  are  inches  and 
resolution  is  0.1  inch. 

An  integer*2  variable  or  array  element  where  the 
MOVPTR  subroutine  stores  a  status  code  describin'j 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutir  ^, 
STATUS  has  a  value  of  1.  Otherwise,  either  ci 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 


Description : 

The  MOVPTR  subroutine  moves  the  GRAPHIC  POINTER 
down  the  page  and  Y  inches  across  the  page 
REFERENCE  ORIGIN. 


po  s  i  t  i  o  n  X  inches 
from  the  current 
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A.  15   MOVREF 

Move  REFERENCE  pointer 

Format : 


MOVREF  (XR,  YR  STATUS) 


Arguments: 

^^  A  real  variable  for  the  new  REFERENCE  X  coorJinate 

is  the  vertical  distance  in  inches  from  the  PAGE 
origin.  XR  must  be  at  least  as  large  as  che 
current  SECTION  origin.   Resolution  is  0.1  inch. 

^^  A  real   variable   for   the  horizontal   distance   in 

inches  from  PAGE  origin.  The  resolution  is  0.1 
i  nch . 

STATUS  An  integer*2  variable  or  array  element  where  the 
MOVREF  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request)  .  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  tc- 
Appendix  C  cor  a  description  of  this  problem. 

Description : 

The  MOVREF  subroutine  moves  the  REFERENCE  ORIGIN  to  a  point  X 
inches  down  the  page  and  Y  inches  across  the  page  from  the  PAGE 
origin  or  absolute  position. 
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A.  16   PAGE 

Advance  to  the  next  plot  pacje. 

Terminate  the  current  page  by  processing  current  contents  of 
REQUEST  BUFFERS  and  reinitialize  for  the  next  LXY  page.  BCP  uses 
the  LXY  EVFU  unit  to  advance  the  printer's  paper  to  the  next  page 
position.   This  is  done  via  the  formfeed  character  014  (octal). 

Fo  rmat : 


PAGE  (STATUS) 


Arguments : 

STATUS  An  integer*2  variable  or  .irray  element  ^fhere  the 

PAGE  subroutine  stores  a  status  code  describing  the 
action  taken  on  the  CALL,  (or  request).  On  normal 
or  successful  return  from  the  subroutine,  STATUS 
has  a  value  of  1.  Otherwise,  either  an  error  or 
warning  condition  results.  Refer  to  Appendix  C  for 
a  description  of  this  problem. 

Descr  ipt  ion : 

Page  automatically  rails  PROCES  as  required  to  output  the  current 
REQUEST  BUFFER  contents. 


A-23 


A.  17   PROCES 

Initiates  Phase  2  processing. 

Format : 


PROCES  (STATUS) 


Arguments : 

STATUS  An  intejer*2  vari<^bie  or  arr^iy  element  where  the 

PROCES  sabroutine  stores  a  status  code  describinj 
the  action  taken  on  the  CALL  (or  request^  .  ')n 
normal  or  successful  return  from  the  subroutitie, 
STATUS  has  a  value  of  I.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  tc 
Appendix  C  for  a  description  of  this  problem. 

Descr Ipt  ion : 

PROCES  initiates  Phase  2  processing  (Section  l.l)  is  whert?  t.h. 
PROCES  subroutine  is  used  to  force  the  Phase  2  (Section  l.l) 
processing  of  the  stored  requests.  The  section  height  i% 
determined  by  height  of  the  resultant  height  of  the  graphic  or 
plotted  figures  defined  by  the  stored  request!5.  The  section 
height  is  adjusted  to  be  a  multiple  of  0.5  inch.  Thus,  If  fc.r 
example  the  height  of  the  graphics  in  the  SECTION  is  }.6  inches, 
the  height  is  adjusted  tc  4.0  inches. 
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A. 18   REPEAT 

Repeat  the  current  contents  of  the  PUiyUKST  3UFFt:HS. 

Format  : 


REPEAT  (NH,  NV,  STATUS) 


Arguments : 

NH  Number     of     times     to     repeat     the     jr  iphics     jcrosij     the 

paqe    (her  i  zontal I y)  . 

NV  Number  of  times  to  repe.it   the   jriphicb  Jown  the 

pa'^e  (  ver  t  ical  1  y)  . 

STATUS  An  intejer*2  variable  or  array  elem»!nt  where  the 

REPEAT  subroutine  stores  a  status  code  rlescribin-j 
tne  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  I.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 

Descr 1 pt Ion : 

Repeat  the  GRAPHIC  REQUESTS  currently  in  the  REgUKST  HUFFERS  a 
specified  number  of  times.  The  caller  specifies  how  many 
horizontal  and  vertical  repeats  are  want, id. 

The  requests  are  repeated  at  HTAB  Interval.!  across  the  page  and 
VTAB  separation  vertically.  Automatic  PAGE  commands  are  provirled 
upon  completion  of  each  plot  page  whenever  the  repeat  count  is  not 
yet  exhausted . 

NOTE 
It   is   important   for   the   caller   to  get   up 
proper  values  for  HTAB  and  VTAB   (see  SETTAB) 
before  calling  REPEAT  to  set  proper  spacing 
between  repeated  figurt^s. 


A. 19   PUTFRM 

Insert  a  fixed  form  at  a  specified  point  on  the  plot  pag 

Format : 


e 


PUTFRM  (X,  Y,  STATUS) 


Arguments: 

^'"^  Real   variables  or   array  elements   .specify   a   new 

position  for  the  REFERENCE  ORIGIN  for  insertion  of 
the  fixed  form.  The  units  are  inches  and 
resolution  is  0.1  inch. 

STATUS  An  integer*2  variable  or  array  element  where  the 

PUTFRM  subroutines  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request)  .  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  tc; 
Appendix  C  for  a  description  of  this  problem. 

Description : 

PUTFRM    places    a    fixed     form    at    any    number    of    places    on    the    outpiit 
PAGE.  PUTFRM     cannot     be     used     when     no      fixed      form     exists      (see 

GETFRM)  .       One    copy    of    the    form    graphic    content     is    stored     for     any 
number    of    insertions    by    PUTFRM. 
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A.  20   SAVFRM 

Terminate  form  definition. 

Format : 


SAVFRM    (STATUS) 


Arguments: 

STATUS  An  inte9er*2  variable  or  array  element  where  the 

SAVFRM  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (cr  request).  On 
normal  or  successful  return  from  the  subroutine, 
ITATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 

Description: 

SAVFRM  terminates  the  form  definition  ir:de  of  operation  and  writes 
the  current  contents  of  the  REQUEST  BUFFERS  onto  the  forrrs  file. 
These  REQUESTS  thus  become  the  form  graphics  (graphic  description) 
that  may  be  read  back  and  inserted  in  the  REQUEST  BUFFERS  by  the 
GETFRM  subroutine  at  a  later  time.  The  REQUE^'T  BUFFERS  are  then 
cleared  . 
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A. 21   SETFIG 

Set  up  default  figure  parameters. 

These  values  are  used  when  figures  such  as  barcode  and   block 
characters  are  requested. 

Format : 


SETFIG  (SIZE,  RATIO,  DBHT,  TEXT,  STATUS) 


Arguments: 

SIZE  A   real   variable   or   array   element   .spe<.:ifies 

character  size  (height  and  width)  in  inches.  The 
resolution  is  0.1  inch.  The  initial  (or  default) 
value  for  size  is  1.0  inch. 

RATIO  An  integer*2  variable  or  constant  that  specifies 

the  CODE  39  barcode  ratio.  This  is  the  ratio  of 
line  widths  between  the  thick  lines  (or  spaces)  to 
the  thin  lines  (or  spaces)  in  the  barcode  figure 
itself.  Ratio  is  either  2  or  i.  The  initial  or 
default  value  for  ratio  is  two. 

DBHT  A  iogical*2  variable  or  constant  has  a  value  of 

.TRUE,  to  draw  block  characters  at  a  height  that  is 
double  the  width.  The  default  or  initial  value  for 
DBHT  is  .FALSE. 

TEXT  A  logical*2  variable  or  constant  specifies  whether 

to  include  the  text  when  the  barcode  figure  is 
drawn.  The  text  when  included  is  inserttni  as  the 
lower  0.2  inch  of  the  barcode  figure.  The  default 
(or  initial)  value  of  text  is  .FALSE. 

STATUS  An  integer*2  variable  or  array  element  where  the 
SETFIG  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  .subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  descripticm  of;  thi;j  problem. 

Descr  iption: 

SETFIG  provides  the  caller  with  the  means  to  change  the  values  of 
the  system  default  figure  parameters.  SIZE  and  DBHT  may  be 
temporarily  overriden  when  making  a  BLOCK  or  BCODE  subroutine  call 
by  using  the  appropriate  arguments.  These  parameters  are  more 
important  to  the  CREATE  program  user  than  the  BCl'LIB  user.  The 
values  for  RATIO  and  TEXT  may  only  be  changed  by  the  .".ETFIG 
subrout  ine . 
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A.  22       SETPAG 

Set    up   default    page    parameters. 

Format : 


SETPAG  (XLIM,  YLIM,  EVFU,  STATUS) 


Arguments : 

XLIM  A  real  variable  or  constant  specifies  pacje  length 

in  inches  for  limit  checks  and  PAGE  command  use. 
XLIM  is  entered  into  the  LXY  '  s  EVFU  unit  to 
determine  the  distance  that  the  paper  is  to  advance 
when  the  PAGE  (form  feed)  subroutine  is  processed. 
Whenever  the  EVFU  unit  is  used,  XLIM  cannot  be 
greater  than  22.0  inches  and,  in  addition,  must  be 
expressed  to  the  nearest  0.5  inch  increment. 

YLIM  A  real  variable  or   constant   specifies   the   page 

width  in  inches  for  limit  checks.  The  resolution 
is  0.1  inch.   The  maximum  width  is  13.2  inches. 

EVFU  Logical*2  flag.    If  EVFU  is  .TRUE.,  bypass  setup 

and  use  of  the  LXY  EVFU  unit  for  veritical  form 
control.  EVFU  value  of  0  is  the  same  as  .FALSE. 
The  default  (or  initial)  value  for  EVFU  is  .FALSE. 
When  EVFU  is  .FALSE.,  the  LXY  EVFU  is  programmed  to 
have  a  form  length  equal  to  SETPAG's  XLIM.  Whenever 
the  PAGE  routine  is  called,  the  line  printer's 
paper  is  advanced  according  to  the  length  defined 
by  XLIM.  When  EVFU  is  .TRUE.,  the  paper  is 
advanced  according  to  the  mechanical  form  feed 
length  set  up  on  the  printer  itself. 

STATUS  An  integer*2  variable  or  array  element  where  the 
SETPAG  subroutine  stores  a  status  ccide  describing 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Oth'^rwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Ajipendix  C  for  a  descriptic-n  of  this  problem. 

Description : 

SETPAG  provides  the  caller  access  to  the  system  default  page 
parameters.  These  parameters  may  be  changed  before  the  first  call 
to  a  graphic  figure  subroutine  (BLOCK,  BCODE ,  etc.). 


• 
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A.  23   SETTAB 

Set  up  default  TAB  distance. 

Format : 


SETTAB  (HTAB,  VTAB,  STATUS) 


Arguments : 

HTAB 

VTAB 
STATUS 


A  real  variable  constant  to  chanje  the  value  (.  t 
horizontal  tab  lenqth  in  inches.  Rescilution  is  0 .  1 
i  nch . 

A  real  variable  or  constant  to  change  the  value  of 
vertical  tab  heiqht  in  inches.  Resolution  is  «.L 
inch. 

An  integer*2  variable  or  array  element  where  the 
SETTAB  subroutine  stores  a  status  ccKie  describinq 
the  action  taken  on  the  CALL  (cr  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  I.  Otherwise,  either  an 
error  cr  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 


Description: 


SETTAB  enables  the  caller  to  change  the  values  for  the  TAB 
parameters  (vertical  and  horizontal  tabs).  The  TAB  parameters  are 
used  to  : 

•  Move  the  REFERENCE  ORIGIN  by  the  TAB  subroutine,  and/or 

•  Set  up  repeat  intervals  for  use  by  the  REPEAT  subroutine. 


*♦ 
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A.  24       TAB 

Moves    REFERENCE    ORIGIN     i  ncr  ement  ci  I  1  y .        The    distance     is    dete  rm  i  no'l 
by    VTAB    and    HTAB     (see    SLTTAB) . 

Format : 


TAB     (NH,     NV,     STATUS) 


Arguments: 

NH  An      inte3er*2     variable     or      constant     specifies     a 

number  of  horizontal  t-ibs  to  m(  ve  the  REFERENCE 
ORIGIN. 

NV  An      inte'3er*2     variable     c- r      constant     specifies     a 

number  of  vertical  tabs  to  move  the  REFERENCE 
origin. 

STATUS  An      integer*2     variable     or     array     element     ^^here     the 

TAB  subroutine  stores  a  status  code  describinj  the 
action  taken  on  the  CALL  (or  request).  On  nc  rmal 
or  successful  return  from  the  subroutine,  STATUS 
has  a  value  of  1.  Otherwise,  either  an  error  cr 
warning  condition  results.  Refer  to  Appendix  C  f c r 
a    description    of    this    problem. 

Descr  ipt Ion : 

TAB  enables  the  caller  tc  mcve  the  REFERENCE  ORIGIN  multiples  of 
predefined  distances  called  TABS  in  either  or  both  the  horiiuntal 
and  vertical  directions. 
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A. 25   TEXT 

Draw  0.1  inch  hi>jh  alphanumeric  characters. 

Fo  rmat : 


TcXT     (N,     LIST,     [)X,     DY ,     STATUS)) 
TEXTA     (N,     LIST,     X,     Y,     llTATUS) 
TEXTP     (S,     LIST,     P,     STATUS) 


Arguments : 

N  An   intejer*2   variable   of   array   ••  i  ein-Mit   i  ;   •  h.- 

number  of  characters  In  LIST  (beUiw). 

LIST  A  character   variable  or   constant   .•■n  i.  i  i  n  i  n  j  iu>- 

characters  tc  beina  plotte'l. 

DX,DY  Real  variables  or  array  elements  specify  an  offsiM. 

distance  in  inches  (  resfj  1  ut  ion  of  ^.1  inch)  to  mov.- 
the  GRAPHIC  POINTER  f  c;  r  ins.irtion  of  the  TPXT 
char  acter  s . 

X,Y  Real  variables  or   array  elements   specify  a   new 

position  for  the  GRAPHIC  POINTER  for  insertion  oJ 
the  TEXT  characters.  The  units  are  inches  and 
resolution  is  0.1  inch. 

P  An  intejer*2  variable  or  array  element  specifies  .i 

form  LABEL  POINT.  The  GRAPHIC  POINTER  is  set  to  the 
value  of  the  namei  LABEL  POINT  for  insertion  of  the 
TEXT  characters.   P  is  a  number  between  I  anrl  12. 

STATUS  An   intejer*2  variable  or  arr-iy  '-lement  where  the 

TEXT  subroutine  stores  a  status  code  describinfj  the 
action  taken  on  the  CALL  (or  request).  On  norma! 
or  F  jccessful  return  from  the  subroutine,  ;;tatus 
has  a  value  of  1.  Otherwise,  either  an  error  or 
warning  condition  results.  Refer  to  Appendix  C  for 
a  description  of  this  problem. 

Description: 

TEXT  allows  the  caller  to  insert  text  of  hei'jht  tl .  1  i\ir\,  mto  the 
plot  page.  The  text  is  not  affected  by  the  SIZE  mi  DHHT  t.'f.iults 
that  control  the  BLOCK  character  shapes. 
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A. 26   VDASH 

Dashed  vertical  line. 

Format: 


VDASH  (LENGTH,  DX,  DY ,  THICK,  STATUS) 
VDASHA  (LENGTH,  X,  Y,  THICKS,  STATUS) 
VDASHP  (LENGTH,  P,  THICK,  STATUS) 


Arguments: 

LENGTH 

DX,[^ 


X,Y 


THICK 


STATUS 


Descript  ion 


A  real  variable  or  constant  specifies  the  line 
length  in  inches  with  a  resolution  of  0.1  inch. 

Real  variables  or  array  elements  specify  an  offset 
distance  in  inches  (resolution  of  0.1  inch)  to  move 
the  GRAPHIC  POINTER  for  insertion  of  the  BLOCK 
characters. 

Real  variables  or  array  elements  specify  a  new 
position  for  the  GRAPHIC  POINTER  for  insertion  of 
the  BLOCK  characters.  The  units  are  inches  and 
resolution  is  0.1  inch. 

An  integer*2  variable  or  array  element  specifies  a 
form  LABEL  POINT.  The  GRAPHIC  POINTER  is  to  be  set 
to  the  value  of  tne  named  LABEL  POINT  for  insertion 
of  the  block  characters.  P  is  a  number  between  1 
and  12. 

A  real  variable,  constant,  or  array  element  speci- 
fies the  line  thickness.  When  THICK  has  a  value  of 
0,  a  line  of  normal  thickness  (approximately  0.039 
inch)  io  drawn.  A  nonzero  value  of  THICK  specifies 
the  actual  line  thickness.  THICK  is  expressed  in 
whole  and/or  tenth  inch  units. 

An  integer*2  variable  or  array  element  where  the 
VDASH  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request).  On 
normal  or  successful  return  from  the  subroutine, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error  or  warning  condition  results.  Refer  to 
Appendix  C  for  a  description  of  this  problem. 


VDASH  provides  the  caller  with  a  facility  to  draw  dashed  vertical 
lines.  The  length  of  the  dashed  line  segments  and  spaces  between 
the  segments  is  0.1  inch. 
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A. 27   VLINE 

Dashed  vertical  line. 

Format : 


VLINE  (LENGTH,  DX, 
VLINEA  (LENGTH,  X, 
VLINEP  (LENGTH,  P, 


DY,  THICK,  STATUS) 
Y,  THICK,  STATUS) 
THICK,  STATUS) 


Arguments: 

LENGTH 

DX,Dy 
X,Y 


Line  length  in 
(real  var  iable) 


inches  with  resolution  of  0.1  inch 


Real  variables  or  array  elements  specify  an  offset 
distance  in  inches  (resolution  of  H.l  inch)  to  move 
the   GRAPHIC   POINTER   for   insertion   of   the   LIN' 
characters. 

Heal   variables  or   array  elements   spec  fy   a   new 

position  for  the  GRAPHIC  POINTER  for  i  sertion  of 

the  LINE.   The  units  are  inches  and  re  jlution  is 
0. 1  inch . 


• 


THICK 


STATUS 


An  integer*2  variable  or  array  element  specifies  a 
form  LABEL  POINT.  The  GRAPHIC  POINTER  is  to  be  sat 
to  the  value  of  the  named  LABEL  POINT  for  insertion 
of    the    LINE. 

A  real  variable  or  array  element  specifies  the  line 
thickness  in  inches.  The  resoituion  is  0.1  inch. 
When  THICK  has  a  value  of  0,  a  line  of  nf;rmal 
thickness    is    drawn    (approximately    0.039     inch). 

An  integer*2  variable  or  array  element  where  the 
VLINE  subroutine  stores  a  status  code  describing 
the  action  taken  on  the  CALL  (or  request).  On  ncir- 
mal  or  successful  return  from  the  subrc)Utino, 
STATUS  has  a  value  of  1.  Otherwise,  either  an 
error      or      warning      condition      results.  Refer      to 

Appendix    C    for    a   description    of    this    problem. 


Descr i  ption: 

VLINE  draws  a  solid  vertical 
of  the  GRAPHIC  POINTER. 


line  starting  at  the  current  positif)n 
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APPENDIX  B 
GLOSSARY 


EVFU 


FORM  BASE 


LXY   printer/plotter's    electronic  vertical 

forms  unit.   This  unit  is  set  up  with  the  page 

length  (or  form  feed  length)  and  is  used  to 

advance  the   LXY  paper   to   the  next  physical 
page . 

A  point  on  the  FORM  boundary  (upper  left 
corner)  that  is  aligned  to  the  REFERENCE 
ORIGIN  at  the  time  of  form  insertion  (see 
GETFRM,  Appendix  A,  Section  A. 9).  All  FORM 
GRAPHICS  and  LABEL  POINTS  are  stored  on  the 
FORMS  file  with  the  position  (X  and  Y) 
expressed  relative  to  the  FORM  BASE  on  the 
fo  rm . 


FORMS 


GRAPHIC  FIGURES 


A  collection  of  GRAPHIC  COMMANDS  jr  REQUESTS 

that  can  be  saved  and  later  called  to  recreate 

a  plotted  output.   Additional  graphic  data  can 

be  inserted  into  the  form  at  the  time  of 
actual  output . 

Any  plotted  figures  generated  by  the  BCPLIB 
routines  (such  as  barcodes,  block  character, 
1 ines ,  etc . ) . 


GRAPHIC  POINTER 


This  is  insertion  position  on  the  PLOT  PAGE 
for  graphic  figures  (such  as  barcodes,  block 
characters,  lines,  etc.). 


m 


GRAPHIC  REQUEST 


This  is  the  stored  (or  buffered)  data  that 
occurs  when  the  user  calls  on  the  BCP  software 
to  draw  something  such  as: 

•  To  the  system  operr.tor  (or  CREATE  user). 
This  is  the  result  of  entering  a  graphic 
figure  command  (BCODE,  BLOCK,  TEXT,  VLINE, 
HLINE,  VDASH,  HDASH,  DEFFRM,  PUTFRM)  or, 

•  To  the  system  programmer  (or  BCPLIB  user) . 
This  is  a  result  of  calling  one  of  the 
GRAPHIC  SUBROUTINES. 


LABEL  POINTS 


• 


A  set  of  offset  points  (defined  at  form  crea- 
tion time)  defined  relative  to  the  FORM  BASE. 
LABEL  POINTS  can  later  be  referenced  to 
position  variable  GRAPHIC  FIGURES  for 
insertion    at    the    time   of    actual    plot    output. 
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PAGE  (PLOT  PAGE)     The  PAGE   (or   PLOT   PAGE)   is   the   external 

equivalent  of  the  LXY  PRINTER/PLOTTER  page. 
The  PAGE  length  and  width  is  adjustable  to 
match  the  PRINTER/PLOTTER  page  length  and 
width . 

REQUEST  A  general  term  for  GRAPHIC  REQUEST.   This  also 

includes  all  nongraphic  figure  CREATE  commands 
and  BCPLIB  subroutine  calls  (such  as  MOVHEF, 
MOVPTR,  etc.)  . 

SECTION  A  variable  sized  portion  of  the  output  page. 

The  plot  data  may  be  output  by  a  sequence  of 
PAGE  SECTIONS  instead  of  whole  PAGES  (this  is 
usually  done  when  there  are  toe  many  GRAPHIC 
REQUESTS  to  buffer  for  the  entire  PAGE). 
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APPENDIX  C 
ERROR  MESSAGES 


C.l   WARNINGS 

+2  REQUEST  BUFFER  NEARLY  FULL  —  This  wa r n i n j  message 
occurs  when  five  or  fewer  storage  packets  remain  in  the 
request  pool  . 

C.2   ERROR 

-  100      GRAPHIC   FILE  WRITE   ERROR   —  This  error   occurs   when 

writing  plot  information  on  the  GRAPHICS  FILE.  The 
REQUESTS  for  this  SECTION  are  lost  and  the  plot  must  be 
restarted.  Check  for  device  problems  (such  as  disk 
full,  device  offline,  etc.). 

-  101      CANNOT  OPEN  GRAPHIC  FILE  —  This  happens  while  trying  to 

initialize  or  open  a  file  for  graphic  output  and  an 
error  condition  occurs.  It  is  impossible  to  continue 
with  the  current  plot.  Check  for  device  problems  (such 
as  disk  full,  device  off-line,  illegal  UIC,  etc.). 

-  102      GETFRM  -  ERROR  CLOSING  FORMS  FILE   —  The   FORMS   file 

following  the  contents  of  the  defined  form  may  be  lost. 
Check  for  device  problems  (such  as  disk  full,  device 
o  f f-1 ine ,  etc  . )  . 

-  103      ILLEGAL  ARGUMENT   (PARAMETER)   SPECIFIED  ~  One  of   the 

parameters  supplied  by  the  user  is  illegal  (such  as 
characters  in  a  numeric  field).   Reenter  the  request. 

-  104      GETFRM  -  CANNOT  OPEN  FORMS  FILE  —  The  program  cannot 

open  the  FORM  file  requested  by  the  DEFFRM  request. 
This  happens  if  the  form  was  not  saved  (SAVFRM)  at  the 
time  of  definition,  if  the  form  name  was  misspelled,  or 
if  device  problems  occurred  (such  as  off-line,  write 
locked  device,  etc.). 

-  105      GETFRM  -  FORMS  FILE  READ  ERROR  --  This  error   occurs 

while  reading  the  FORMS  file  as  a  result  of  the  GETFRM 
request.  Check  for  device  problems  (such  as  disk  full, 
device  off-line,  etc.)  . 

-  106      DEFFRM  -  CANNOT  CREATE  FORM  FILE   •--   A  FORM  File  was 

initialized  (or  opened)  in  response  to  a  DEFFRM  request 
and  an  error  occurred.  Check  for  device  prot)lems  (such 
as  illegal  device,  device  off-line,  etc.). 
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-  107      DEFFRM  -  FORMS  FILE  WRITE  ERROR  —  Error  occurred  while 

trying  to  write  on  the  FORMS  file  following  the  DEFFRM 
request.  The  contents  of  the  currently  defined  form  may 
be  lost.  Check  for  device  errors  (such  as  write-locked 
device,  device  off-line,  etc.). 

-  108      SAVFRM  -  ERROR  CLOSING  FORMS  FILE  -~  This  error  occurs 

while  trying  to  close  the  FORMS  file  following  the 
SAVFRM  request.  The  contents  of  the  currently  defined 
form  may  be  lost.  Check  for  device  problems  (such  as 
device  off-line,  write-locked  device,  etc.). 

-  109      X  LIMIT  FAILURE  (SECTION)  —  The  current  request   (TAB, 

MOVREF,  GETFRM,  or  PUTFRM)  defines  a  reference  in  the 
previous  PAGE  SECTION  (or  PAGE)  If  a  PACE  SECTION  or 
PAGE  was  processed,  any  further  requests  to  draw  graphic 
figures  or  part  of  a  figure  in  that  PAGE  SECTION  or  PAGE 
cannot  be  accepted. 

-  110      X  OR  Y  LIMIT  FAIL  -  OUTSIDE  PAGE  BOUNDARIES  —  Thu-  X  <•  r 

Y  parameter  requested  was  outside  the  page  bound  iries. 
Type  SHOW  PAGE  to  view  the  current  default  paje 
boundar  ies . 

-  Ill      FORM  DEFINITION  -  X  OR  Y  OUTSIDE  FORM  H(3UNDARIKS  —  This 

error  occurs  only  during  the  forms  definition  mode.  The 
current  REQUEST  (BCODE,  BLOCK,  TEXT,  etc.)  defines  a 
figure  whose  area  extends  beyond  the  limits  defined  by 
the  DEFFRM  REQUEST. 

-  112      X  OR  Y  LIMIT  FAIL  -  OUTSIDE  REFERENCE  BOUNDARIES  —  The 

X  or  Y  parameter  requested  was  outside  the  reference 
boundaries.  Type  SHOW  POS  to  view  the  current  default 
REFERENCE  ORIGIN. 

-  113      Unused. 

-  114      REQUEST   BUFFER   FULL   —   No   GRAPHIC   REQUESTS   can   be 

accepted  until  Phase  2  processing  is  initiated.  The 
current  REQUEST  wis  aborted.  Use  the  PROCES,  P^GE, 
REPEAT,  FINISH  (CREATE  END)  REQUEST  to  continue. 

-  115      CANNOT  CHANGE  FIGURE  PARAMETERS  WHILE  PLOT   IN  PROGRESS 

--  It  is  illegal  to  make  a  SETFIG  retjuest  once  plotting 
starts  (this  is  following  any  graphic  figure  request 
such  as  BCODE,  BLOCK,  TEXT,  etc.). 

-  116      PUTFRM  -  NO  FORM  FIXED  IN  MEMORY  -  A  form  must  be  fixed 

in  memory  with  GETFRM/F  before  PUTFRM  can  lie  requested. 
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-  117      GETFRM  -  FORM  ALREADY  FIXED  IN  MEMORY  —  Once  a  form  i -^ 

fixed  in  memory  the  a^;er  cannot  request  another  form 
(GETFRM),  fixed  or  not  fixed.  The  user  must  request 
ERASh,  FIX  before  another  GETFRM  REQUEST  can  be  made. 

-  118      SETPAG   -   X   LIMIT   BEYOND   EVFU   CAPABILITY   —   The   LXY 

PRINTER/PLOTTER  EVFU  facility  ha.s  a  maximum  f-^rrn  length 
of  2  2.0  inches  (in  th'^  X  direction). 

-  119      ILLEGAL  REQUEST  SEQUENCE  —  The  DEFFRM  request  cannot  be 

made  at  this  time  because  the  system  is  already  in  the 
FORM  definition  mode  or  because  plotting  is  already  in 
progress . 

-  121      SAVFRM   -  FORM   NOT  BEING   DEFINED   —   A   form   mur.t   be 

defined  (DEFFRM)  before  it  can  be  saved. 

-  122      CANNOT  PROCESS  PLOT  SECTION  WHILE  DEFININ:;.  A  F  )RM  --  The 

PLOT  section  cannot  be  processed  (PROCES  or  REPEAT 
request)  while  a  form  is  beinj  defined. 

-  123      Unused. 

-  124      FORM  INSERTION  -  X  OR  Y  FORM  LIMIT  VIOLATION  --  Limit 

violation  occurred  while  in  the  form  insertion  mode 
(GETFRM  by  PUTFRM  requests)  .  The  area  covered  by  the 
defined  figure  (resulting  from  a  GRAPHIC  REQUEST  such  as 
BCODE,  BLOCK,  etc.)  extends  beyonrl  the  current  FORM 
limits.  The  REQUEST  is  aborted.  To  continue,  either 
make  an  ENDFRM  REQUEST  or  resposition  the  figure. 

-  125      Y   LIMIT  SPECIFIED   IS  BEYOND  LXY  CAPABILITY  --  The   Y 

parameter  requested  is  beyond  the  1K2  inches  the  LXY  is 
capable  of  handling. 

-  126      X  LIMIT  IS  NOT  A  MULTIPLE  OF  H.S  INCH  --  The  X  parameter 

requested  must  be  a  multiple  of  0.S  inch.  PAGE  -r  VTAH 
lengths  (SETPAG)  must  be  expressed  in  »1  .  S  in.:h 
i  ncr ements . 

-  127      PLOT  NOT   INTIALI'ZED  —  The   PLOT  must   be   i  n  i  t  i  a  I  i  z*.-  I 

before  any  r" juests  can  be  entered.  Use  the  CREATE 
NEWPLT  command  or  the  BCPLIH  I N IT  subroutine  to 
initialize  the  PLOT. 

-  128  PLOTTING  IN  PROGRESS:  CANNOT  RESET  PAGE  PARAMETERS  -- 
You  cannot  make  a  SETPAG  REQUEST  once  plotting  starts 
(this  is  following  any  graphic  figure  recjuest  such  as 
BCODE,  BLOCK,  TEXT,  etc.). 
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-  129      PLOT  IS  ALREADY  INITIALIZED:  CANNOT  BE  REINITIALIZED  — 

A  PLOT  was  already  initialized  and  is  currently  in  use. 
If  a  new  plot  file  is  needed,  the  current  plot  file  must 
be  terminated  by  the  CREATE  user's  END  command  or  BCPLIB 
user's  FINISH  request.  After  a  FINISH  (END)  request,  a 
new  plot  can  be  initialized. 

-  130      Unused. 

-  131      REQUEST  BUFFER  EMPTY,  NO  OUTPUT  POSSIBLE  ~  A  PROCES  or 

REPEAT  REQUEST  was  made,  but  the  REQUEST  BUFFERS  were 
empty. 

-  132      REPEAT  -  TAB  HEIGHT  SMALLER  THAN  HEIGHT  OF  GRAPHICS  ~ 

The  height  requested  with  VTAB  is  smaller  than  the 
height  of  the  graphics  to  be  repeated.  The  current  VTAB 
parameters  can  be  viewed  by  typing  SHOW  PAG. 

-  133      ILLEGAL  USE  OF  GETFRM  OR  PUTFRM.    MUST  TERMINATE  WITH 

ENDFRM. 

-  134      CANNOT  USE  "MOVREF"  REQUEST  DURING  FORM  INSERTION. 

-  135      GETFRM  -  CANNOT  FIX  A  FORM  WHILE  DEFINING  A  FORM  — 

During  the  form  definition  mode,  a  form  cannot  be  fixed 
in  memory. 

-  136      CREATE  COMMAND  ERROR 

-  137      GETFRM  -  FIXED  FORM  DOES  NOT  CONTAIN  GRAPHIC  DATA 

-  333      UNRECOGNIZED  ERROR  —  This  can  be  caused  by  a  program 

"bug"  or  a  memory  error. 
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APPENDIX  D 
BCP  VERIFICATION 


Verification  of  the  BCP  software  can  be  carried  out  on  three 
levels. 

•  Verify  the  LXY  plotting  capability  only 

•  Verify  the  BCPLIB  graphics  library 

•  Verify  the  CREATE  program  operation 

Before  starting  the  installation  verificatio  procedures,  set  the 
default  area  to  that  which  was  entered  during  installation.  For 
example : 

•  For    RSX-llM: 

Set    the    UIC    to    the    installation    work    area: 
>SET    /UIC=[?-00,2001 

•  For    VAX /VMS: 

Set    the    default    to    the    installation    destinatirn    work    area: 
$SET    DEF    DBC0: [BCP] 

If  the  LXY  PRINTER  characteristics  (lowercase,  printall, 
width=134,  and  nowrap)  were  not  set  during  the  BCP  instal- 
lation, they  should  be  set  at  this  time.  The  OPER  and 
LOG_^IO  privileges  are  needed  to  change  the  printer  charac- 
terTstics.  The  privileges  and  printer  characteristics  can 
be    set    as    follows. 

$SET    PROC/PRIV= (OPER,LOG_IO) 
$SET    PRINTER    ddnn : /LOWERCASE 
$SET    PRINTER    ddnn :/PRINTALL 
$SET    PRINTER    ddnn : /WIDTH^l 34 
$SET    PRINTER   ddnn:/NOWRAP 

Where     ddnn:      is     the     device     name     and     number     of     the     LXY 
PRINTER/PLOTTER. 

To  verify  the  LXY  printer's  plot  mode  of  operation,  the  BCP 
distribution  includes  a  plot  image  file  called  TEST.PLT.  This 
tests  not  only  the  printer's  plot  mode  operation,  but  also  tho 
ability  of  the  operating  system  and  its  line  printer  driver  to 
pass    plot    data. 
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Transfer  the  file's  contents  to  the  printer  as  in  the  fclicwinq 
example . 

•  For    RSX-llM: 

>PIP  LP0:  =  TEST.PLT 

•  For    VAX/VMS: 

$PRINT/NOFEED/DEV=ddnn:    TEST.PLT 

To  verify  the  BCPLIB  graphics  library,  the  BCP  distributUn 
includes  a  special  user  applications  program  for  this  purpose, 
called  DEMO.  DEMO  is  completed  and  task  built  with  the  BCPLIB 
modules    via    a    special    command    file    by    the    same    name. 

•  For    RSX-llM: 

To     install    DEMO,    type: 

>§DEMO 

and     respond     to     the     command     procedure's    dialog     as     in     the 
following       examples.  The      operator's       responses      are 

underlined.      Before    calling    up   Demo,    be    sure    that    you    have 
already      installed      BCPLIB.  This      installation      takes 

approximately    4    minutes. 

>@DEMO 

>*   HAVE    YOU    COMPLIED    THE    DEMO    PROGRAM?     [Y/N]:     N 

>*    ENTER    THE    NAME    OF    THE    FORTRAN-77    TASK:     [S]:     F77 

>F77    DEMO=DEMO.FTN 

>*    HAVE    YOU    BUILT    THE    BCP    LIBRARY?     [Y/N]:     Y 

>*    HAVE    YOU    BUILT    THE    DEMO    OVERLAY    DISCRIPTOR    FILE     (ODD?     [Y/Nj:     N 

>*    ENTER    THE    NAME    OF    THE    FORTRAN-77    OTS    LIBRARY:      [S ] :     F4P0TS 

>TKB    @DEMOLNK  

>@    <EOF> 

You   may    now    run    the    DEMO,     for    example: 

>RUN    DEMO 

Upon      completion      of      the      DEMO      program,      transfer      the      resultant 
graphics    (plot    image)     file    to    the    LXY    printer. 

>PIP    LP0: =DEMO.PLT 

Refer    to     Figure    D-1     for     the     r-.-sultant    plot.        (Expect    to     see     four 
printouts   of    the    figure    shown). 
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Figure  D-1   DEMO  PLOT 


For  VAX /VMS: 


The  VAX/VMS  installation  procedure  (Ch.ipter  4)  gives  the 
user  the  option  of  compiling  and  linking  the  demo  at  the 
time  of  system  installation.  The  demc.  program  can  be 
compiled  and  linked  at  any  time  by  typiivj: 

$@DEMO 

To  run  the  DM0  program,  type: 

$RUN  DEMO 

Upon  completion  of  the  DEMO  program,  transfer  the 
resultant    graphics    (plot     image)     file    to    the    LXY    printer. 

$PRINT/NOFEED/DEV=ddnn :       DEMO. PLT 
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Where  ddnn:  specifies  a  device  name  .in  i  number  ct     the  LXY 
PRINTER/PLOTTER. 

Refer  to  Figure  D-1  for  the  resultant  plot.    (Expect  to 
see  four  printouts  of  the  figure  shown.) 

CREATE  PROGRAM  VERIFICATION  INSTRUCTIONS 

To  verify  that  the  CREATE  portion  of  the  aCP  software  was  properly 
installed  and  is  working  correctly,  follow  f  ru-  procedure  outlined 
below. 

•  Fo  r  RS  X  - 1  1 M  : 

>RUN  CREATE 

•  For  VAX /VMS: 

$RUN  CREATE 

The  following  sequence  applies  to  both  RSX-ILM  an  1  VAX/VM'.i. 

Initialize  the  plot  file. 

CRT>NEWPLT  CRDEMO.PLT 

Now,  define  the  form.  For  the  CREATE  DEMO,  name  the  form 
CRDEMO.FRM.  The  form  will  be  a  5.0  inch  x  5.0  inch  square, 
outlined  with  0.2  inch  thick  lines.  Text,  block  characters  of 
different  heights,  lines,  and  barcode  will  make  up  the  body  of  the 
fo  rm . 

CRT>DEFFRM  CRDEMO. FRM , 5 , 5 

First,  draw  the  outline. 

CRT>HLINE  5/T=.2 
CRT>VLINE  5/A=0,4.3/T=. 2 
CRT>HLINE  -5/A=4.8, 5/T=. 2 
CRT>VLINE  -5/A=5,0/T=. 2 

Next,  insert  solid  and  dashed  lines  to  act  as  dividers. 

CRT>HLINE  5/A=2.8,0/T=. 2 
CRT>VDASH  2/A=3, 1.8/T=. 2 

Now,  insert  the  block  characters,  text  and  barcode. 

CRT>BLOCK  "DEM0"/A=1 , 1. 2/S=. 7 

CRT>TEXT  "VERIFICATION  PROGRAM  LABEL  FOR"/A--=  1 .  4  ,  1 .  1 

CRT>TEXT  "BARCODE  SOFTWARE" /A=l . 7 , 1 . 7 

CRT>BLOCK  "LABEL  1  OF  4 "/A  =  2 .  3  ,  . 7/S  =  .  i 

CRT>BLOCK  "1  "/A  =  4.  4,  .^) 

CRT>BCODE  "1234  1 "/A= 4. 4,2. 7 
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Check  the  entries  to  see  that  thoy  are  at  the  specified  U  cations. 
If  a  mistake  was  ma-Je  while  enter  in<j  the  graphics  ccminanJs,  typ<i 
"KRASE  REQ"  and  reenter  the  graphics  commands  starting  at  the 
point  where  the  for--,  was  outlined.  If  the  t?ntries  were  correct, 
save  the  torm. 

CRT>SAVFRM 

Usincj  the  "GETFRM"  command,  place  the  form  at  reference  p<;i,-it  1,1. 
Terminate  forms  insertion  with  "ENDFRM".  Process  the  ccntents  c;  f 
the  buffer  with  the  "PROCES"  command.  Terminate  the  current  plot 
with  "END",  then  terminate  the  CREATE  projram  with  "EXIT", 

CRT>GETFRM  CRDEnU.ERM, 1, 1 

CRT>ENDPRM 

CRT>PROCES 

CRT>END 

CRT>EXIT 

Print  the  file,  CRDE'^O.PLT,  on  the  line  print.-r. 

•  Fc'r  RSX-IIM: 

>PIP  LP0: =CRDEMO. PLT 

•  For  VAX/VMS: 

$PRINT/MOFEED/DEV=ddnn:    CRDEMO.PLT 


where  ddnn:   is   the  device  name  and     number 
PRINTER/PLOTTER. 


the      LXY 


The     figure    generated     by    the     procedure     above    generates     a     plotted 
E  i  -1  u  r  e    a  s    i  n    F  i  g  u  r  e    D  -  1  . 


• 


D-5 


BCP  USER  S  GUIDE  Reader  s  Comn.etMs 

AA  N269B  TK 


Your  comments  and  suggestions  will  hel)'>  us  iii  our  continuous  effort  to  irnprnve  the  ((uality  and  useful 
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